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Preface 



This manual describes the procedures used to generate and install the soft- 
ware components for RSTS/E V7.0, the PDP-11 Resource Sharing Time 
Sharing System/Extended. 

The manual also presents information needed to install RSTS/E layered prod- 
ucts software, to change system characteristics, to optimally arrange system 
components, and to correct hardware and software problems. The material is 
of interest to those at an installation who are responsible for hardware and 
software policy and procedure. Certain information is also of interest to field 
service engineers, software support representatives, and system managers who 
are responsible for solving operational problems and for maintaining pub- 
lished changes to system software. 

Before attempting to generate a RSTS/E system, you should be familiar with 
the RSTS/E software, with the hardware on which RSTS/E will run, and with 
any published changes (patches) to system software. For more information on 
RSTS/E documentation for standard and optional software, consult the 
RSTS/E Documentation Directory. For information on hardware supplied 
with RSTS/E, consult the user documents that accompanied the system. 

Procedures for generating and installing diagnostic and optional software are 
described in other manuals provided with that software. 



Documentation Conventions 

This manual uses the following symbology conventions. 

© The © symbol indicates pressing the LINE FEED key. 

(RET) The m symbol indicates pressing the RETURN key. 

IE) The die) symbol indicates pressing the ESCAPE key (shown as ALT 
MODE on some terminals). 

eiS Th^ ( CTRL/x ) symbol indicates holding down the CTRL key while typing 
the character "x". It is usually echoed as "x. In this manual the letter 
"x" represents the capital letters C and Z (i.e., CTRL/C and 
CTRL/Z). 

Color highhghting in examples indicates user input. Unless otherwise noted, 
user input is terminated by pressing the ® key. 
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Chapter 1 

System Generation Overview 



This chapter presents an overview of the RSTS/E V7.0 system generation 
process. The process begins when the person responsible for generating the 
system collects the software components required for system generation, and 
ends when the system is completely generated and installed, ready for general 
time-sharing usage. 



The remaining sections in this chapter describe the structure of the System 
Generation Manual. Included are overviews of all chapters and appendices, 
some basic terms used throughout the manual, a flowchart of the system 
generation process and a summary of the steps you take to generate a RSTS/E 
system. 



The step-by-step summary is included to make the system generation process 
easy to follow. Use this guide, along with the chapters detailing the 40 steps 
involved in the SYSGEN process, for a complete understanding of the 
RSTS/E V7.0 System Generation procedure. 
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1.1 structure of the Manual 



The remaining chapters describe in detail the steps you must take to generate 
a RSTS/E system. The 40 steps that you take to generate your system are 
illustrated in the System Generation Flowchart, Figure 1-1. The chapters are: 



Chapter 2. Bootstrapping the Distribution IVIedium. Steps 1-2 

The first steps in system generation are to collect the software you need, then 
use the hardware bootstrap loader to bootstrap the initialization code into 
memory from the RSTS/E distribution medium. Chapter 2 describes the dis- 
tribution medium bootstrap procedures. DIGITAL distributes RSTS/E on 
7-track magnetic tape (800 bpi), 9-track magnetic tape (800 and 1600 bpi), 
and RK05, RLOl, RK06, and RK07 disk cartridge. The distribution media 
contain the initialization code, other programs, and data files needed to gen- 
erate and tailor a RSTS/E system. 



Chapters. Tailoring the SYSGEN System. Steps 3-11 

After you bootstrap the distribution medium, you must use the initialization 
options to design the SYSGEN system for your installation. The SYSGEN 
system supports a minimal number of each standard RSTS/E device — four 
RK05 units, two units of each other disk type, two units of each type of 
magnetic tape, two keyboards (the console keyboard and one pseudo 
keyboard), one line printer, etc. During the tailoring procedure, you use op- 
tions that perform the following functions: 

1. Initialize RSTS/E disks (DSKINT option). 

2. Copy SYSGEN system files from the distribution medium to the system 
disk (COPY option). 

3. Correct the system code (PATCH option), if necessary. 

4. Specify non-standard hardware configuration (HARDWR option), if 
necessary. 

5. Install the SYSGEN monitor (INSTALL option). 

6. Allocate system files for the SYSGEN system (REFRESH option). 

7. Set system defaults (DEFAULT option). 

8. Specify characteristics (SET option) of device units (e.g., Hne printer), if 
necessary. 

9. Start the SYSGEN system (START option). 

If the console terminal for your system is not a standard type, you may need to 
set its fill factor during generation before using any other option. Use the FILL 
option to do so. Refer to Section 3.15 for a description of the FILL option. 
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In addition to the listed options, the initiaHzation code includes four other 
options, which enable you to bootstrap devices, load stand-alone programs, 
enable the console terminal, and use SAVE/RESTORE to back up a RSTS/E 
disk. These options are not generally required during the tailoring of a 
SYS GEN system; however, it is strongly recommended that you use the 
SAVE/RESTORE program to make a copy of the system disk that you create 
as a result of the system generation process. 



Chapter 4. Generating the RSTS/E Target System. Steps 12-16 

After tailoring and starting the SYSGEN system, your next step is to generate 
a Target system. The system generation process uses several programs that 
copy and edit files, ascertain the system configuration, assemble and link 
components of the RSTS/E Target Monitor. The distribution medium 
contains a program that copies the necessary files to the system generation 
disk and chains to another program, which asks the system configuration 
questions. 

Answering the configuration questions involves declaring permanent settings 
in the RSTS/E Monitor code and BASIC-PLUS Run-Time System, and 
optionally patching the RSX Run-Time System if RSX or BASIC-PLUS-2 is 
to be the system default run- time system. These settings indicate the devices 
and optional software the system will support. Examples of configured ele- 
ments include the device controllers in the RSTS/E Monitor and the mathe- 
matical functions in the BASIC-PLUS Run-Time System. The only way to 
change the configuration is to regenerate the system. Configuring a system is 
different from tailoring a system. When you tailor a RSTS/E system, you 
specify variable factors for the RSTS/E Monitor. You can change the tailored 
elements within their configured limits any time the initialization code is 
running. 

After answering the configuration questions, the next step is to run a batch 
stream which generates and patches the Target monitor and BASIC-PLUS 
Run-Time System. Then the SYSGEN system is shut down. 



Chapter 5. Tailoring the Target System. Steps 17-24 

Your next step is to tailor the Target system as described in Chapter 5. Using 
the same initialization options that you used to tailor the SYSGEN system, 
you do the following: 

1. Initialize, then copy RSTS/E files to disk (DSKINT and COPY option). 

2. Specify the hardware configuration (HARDWR option), if necessary. 

3. Install the Target monitor (INSTALL option). 
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4. Allocate the system files (REFRESH option). 

5. Set system defaults (DEFAULT option). 

6. Specify characteristics for device units (SET option), if necessary. 

7. Start time sharing with the Target monitor (START option). 

Chapter 6. Building System Library Files and Optional Software. Steps 25-40 

DIGITAL supplies a library of system programs on the distribution kit. After 
tailoring the Target system, you can build the library. The build procedure 
copies the system programs to the system disk, then patches and compiles 
them. You can then use the library programs, if necessary, to build optional 
software packages, such as the FORTRAN IV and COBOL languages. You 
can also use the system library programs to produce files containing informa- 
tion for users and files containing commands to be issued at system start up. 
Next, create user accounts, then shut down the system. At this point you can 
change your run -time system to BASIC-PLUS-2 if you want it to be your 
system default run- time system. For your protection, now that you have gen- 
erated your system, you should use the SAVE/RESTORE program to make a 
copy of your system disk. The final steps in the system generation process are 
to start time sharing, verify the system start-up control files, and store the 
distribution and recovery media. You can then make the RSTS/E system 
available for general use. 



Chapter 7. Generating RSTS/E Software during Time Sharing. 

You can generate additional RSTS/E Monitors, BASIC-PLUS Run-Time 
Systems, or both during time sharing using the RTll Run-Time System. You 
need not use the SYSGEN monitor. After ensuring that all the system genera- 
tion programs are on the system, you can run the SYSGEN. SAV program, 
which asks the configuration questions. 

After you answer the configuration questions, you can use SYSBAT.SAV to 
process the batch file that generates the monitor and/or BASIC-PLUS Run- 
Time System. After the batch run terminates, you can shut down the system 
at a convenient time and use the initialization code to install the new monitor 
or make the new run-time system the system default or use the UTILTY 
program to add it as an auxiliary run-time system. 



Appendix A. System Generation Error Messages. 

Errors that may occur during system generation are listed in this appendix. 
The four tables of error messages are: 

1. Initialization code error messages. 

2. Recoverable RTll Run-Time System Errors. 
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3. RTll Run-Time System Fatal Execution Errors. 

4. Batch Error Messages. 

The tables include recovery procedures for each error. 



Appendix B. Disk Device Sizes, System iVIoduie Sizes, and BASIC-PLUS 
l\/lodule Sizes. 

The tables in this appendix list the Disk Device, System Module and 
BASIC-PLUS Module Sizes. Also included in Appendix B is a table of 
System Module and BASIC-PLUS Module Sizes in decimal words. Use this 
chart for determining approximate memory sizes of RSTS/E software 
modules. 



Appendix C. Address and Vector Assignments 

Several devices have so called "Floating Addresses". This means that the 
presence or absence of any floating address device will affect the assignment 
of addresses to other floating address devices. Similarly, many devices have 
"Floating Vectors". According to standards, interrupt vectors must be as- 
signed in a specific sequence and the presence of one type of device will affect 
the correct assignment of interrupt vectors for other devices. Finally, there are 
many devices that have fixed addresses and vectors. This appendix presents 
the algorithms for assignment of floating addresses and vectors. It also lists 
the fixed assignments for devices supported by RSTS/E. 



Appendix D. RSTS/E System Library Control Files. 

This appendix lists and defines the programs associated with the five system 
library control files that are issued with the RSTS/E distribution kit. The 
programs are copied by the BUILD program from the distribution medium, 
compiled, and placed in the system library account, during system genera- 
tion. Of the five, BUILD. CTL is the only system library control file that you 
must add to your system; all RSTS/E systems require the programs contained 
in BUILD. CTL. To incorporate the system libraries you follow the procedures 
in Chapter 6 - Building System Library Files and Optional Software. 



Appendix E. System Generation Examples. 

This section contains two sample generations from bootstrapping the distribu- 
tion medium through creating the recovery medium using the SAVE/ 
RESTORE program. The first example demonstrates the generation of 
RSTS/E on a system which has a small system configuration. For those with 
larger systems, the second example shows how a RSTS/E system is generated 
for systems with large configurations. 
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1,2 Terminology 

Terms found during system generation are: 

Distribution Media: This refers to the disks or magnetic tapes on which 
DIGITAL suppUes the system. 

SYSGEN Disk: Copy the SYSGEN files to this disk and then perform the 
system generation using this as the system disk. Every RSTS/E system has a 
system disk that contains the following elements: 

- a RSTS/E file structure 

- the system initialization code 

- a monitor Save Image Library (SIL) 

- a system default run-time system 

- an error message file 

- a swapping file 

- auxiliary system files (optional) 

Target disk: This is the disk on which the Target system is placed. At some 
installations, the Target disk and the SYSGEN disk are the same. 

Default Run-Time Systems: RTll is the default run-time system for the 
SYSGEN system. RSTS/E run-time system defaults may be BASIC-PLUS, 
RSX, or BASIC-PLUS-2 (BP2C0M). RSTS/E requires that the system 
default run-time system be a keyboard monitor, so that it can prompt the user 
at the terminal and accept command strings. 

Patching: If you have an autopatch kit, you can use it during the creation of 
your system libraries (Chapter 6) to enhance or correct program code. You can 
patch the monitor off-line using INIT.SYS or on-line using the ONLPAT 
program. To apply patches manually^you must refer to the RSTS/E Release 
Notes or issues of the RSTS/E Software Dispatch. 

1.3 Summary of the System Generation Process 

Figure 1-1 flowcharts the entire system generation process. The summary 
sheets following Figure 1-1 provide a concise reference to the steps you use to 
generate a RSTS/E system. 
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Figure 1-1: System Generation Flow Chart 
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Figure 1-1: System Generation Flow Chart (Cont.) 
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step 1. Collect Required Distribution Media 

The RSTS/E System Generation Kit consists of the following disks and tapes: 
Table 1-1: RSTS/E V7.0 System Generation Kits 



DEC Order Number 


Pack ID 


Contents 


7-Track Magnetic Tape 






Kit (800 bpi) 






AP-2772G-BC 




System Generation 


AP-2725G-BC 




System Library I 


AP-C726G-BC 




System Library II 


AP~C881B-BC 




RSX Run-Time System and Library 


AP-D047C-BC 




RMS Run-Time System and Library 


AP-H465A-BC 




RSTS/E V7.0 Patch Kit "A" 


9-Track Magnetic Tape 






Kit (800 bpi) 






AP-2773G-BC 




System Generation 


AP-2753G-BC 




System Library I 


AP-C725G-BC 




System Library II 


AP-C883B-BC 




RSX Run-Time System and Library 


AP-5226D-BC 




RMS Run-Time System and Library 


AP-H466A-BC 




RSTS/E V7.0 Patch Kit "A" 


9-Track Magnetic Tape 






Kit (1600 bpi) 






BB-H751G-BC 




System Generation, System Library I, 
System Library II, RSX Run-Time System 
and Library 


BB-H752G-BC 




RMS Run-Time System and Library 


BB-H753A-BC 




RSTS/E V7.0 Patch Kit "A" 


RK05 Disk Cartridge Kit 






AN-2771G-BC 


SYSGNG 


System Generation 


AN-2751G-BC 


SYSLIG 


System Library I 


AN-5444G-BC 


SYSL2G 


System Library II 


AN-C885B-BC 


RSXLBB 


RSX Run-Time System and Library 


AN-5227D-BC 


RMSKIT 


RMS Run-Time System and Library 


AN-H467A-BC 


PATCHA 


RSTS/E V7.0 Patch Kit "A" 


RK06 Disk Cartridge Kit 






AM-2774G-BC 


SYSGNG 


System Generation, RSX Run-Time System 
and Library 


AM-5445G-BC 


SYSLIG 


System Library I, System Library II 


AM-5228D-BC 


RMSKIT 


RMS Run-Time System and Library 


AM-H468A-BC 


PATCHA 


RSTS/E V7.0 Patch Kit "A" 


RK07 Disk Cartridge Kit 






AY-D526G-BC 


SYSGNG 


System Generation, System Library I, 
System Library II, RSX Run-Time System 
and Library 


AY-D946C-BC 


RMSKIT 


RMS Run-Time System and Library 


AY-H469A-BC 


PATCHA 


RSTS/E V7.0 Patch Kit "A" 


RLOl Disk Cartridge Kit 






AX-D527G-BC 


SYSGNG 


System Generation, RSX Run-Time System 
and Library 


AX-D528G-BC 


SYSLIG 


System Library I, System Library II 


AX-D945C-BC 


RMSKIT 


RMS Run-Time System and Library 


AX-H470A-BC 


PATCHA 


RSTS/E V7.0 Patch Kit "A" 
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Table 1-2: RSTS/E Optional Software Distribution Media 



DEC Order Number 


Pack ID 


Distribution Media 


DECNET/E VI. 






AP-D424A-BC 
AP-C886A-BC 
AN-C887A-BC 
AM-C888A-BC 
AY-D742A-BC 


DECNTA 
DECNTA 
DECNTA 


7-Track Magnetic Tape 
9-Track Magnetic Tape 
RK05 Disk Cartridge 
RK06 Disk Cartridge 
RK07 Disk Cartridge 


AX-D741A-BC 


DECNTA 


RLOl Disk Cartridge 


DECNET/E VI. 1 






AP-D424B-BC 
AP-C886B-BC 
AN-C887B-BC 
AM-C888B-BC 
AY-D742B-BC 
AX-D741B-BC 


DECNTB 
DECNTB 
DECNTB 
DECNTB 


7-Track Magnetic Tape 
9-Track Magnetic Tape 
RK05 Disk Cartridge 
RK06 Disk Cartridge 
RK07 Disk Cartridge 
RLOl Disk Cartridge 


RJ2780 V3.0 






AP-2635D-BC 

AP-2636D-BC 

AN-2633D-BC 

AM-C729D-BC 

AY-H340D-BC 

AX-H339D-BC 


ORCOAD 
ORCOAD 
ORCOAD 
ORCOAD 


7-Track Magnetic Tape 
9-Track Magnetic Tape 
RK05 Disk Cartridge 
RK06 Disk Cartridge 
RK07 Disk Cartridge 
RLOl Disk Cartridge 



Step 2. Mount and Bootstrap RSTS/E Distribution Medium 

A. For magnetic tape distribution: 

The operation of magnetic tape devices is described in the RSTS/E System 
User's Guide. To bootstrap the tape, proceed as follows: 

• Mount the system generation tape on unit with the write enable ring 
removed. See Table 1-1 for part numbers. 

NOTE 

The 9 track, 800 bpi magnetic tape bootstrap in the sys- 
tem initialization code will not use a TU16, TE16, TU45, 
or TU77 tape drive if a TUlO, TEIO, or TS03 drive is 
present. Therefore, if your system includes drives of both 
types (TU10/TE10/TS03 and TU16/TE16/TU45/TU77), 
bootstrap the 800 bpi distribution tape on the TUlO, 
TEIO, or TS03 drive. Similarly, the 1600 bpi magnetic 
tape bootstrap will not use a TU16, TE16, TU45 or TU77 
tape drive if a tape is mounted and on-line on a TS04 
drive. 

• Ensure that the tape is at its load point. (The BOT indicator light comes 
on.) The computer does not bootstrap the device unless the tape is at its 
load point. 
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• Set the ON-LINE/OFF-LINE switch on the tape unit to ON-LINE and 
ensure that the RDY indicator is lit. 

• Ensure that the console terminal is on-line. 

• Follow the instructions in Chapter 2 for the type of hardware bootstrap 
device that is on the system. 



B. For disk cartridge distribution: 

To bootstrap the disk cartridge, proceed as follows: 

• Insert the disk cartridge into a free unit. Part numbers are listed in 
Table 1-1. 

• Ensure that the RDY light is on. 

• Ensure that the WR PROT light is on. 

• Ensure that the console terminal is on-line. 

• Follow the instructions in Chapter 2 for the type of hardware bootstrap 
device that is on the system. 



Step 3. Initialize SYSGEN (and Target) Disks 

A. Follow this procedure to initialize the Target system disk if the following two 
conditions are true: 

• You plan to use separate disks for the SYSGEN and Target systems. 

• The Target system disk does not contain data that you need to preserve. 

1. Physically mount the disk you plan to use as the Target system disk. 

2. Use the DSKINT option to initialize the disk as a system disk. Note 
that initialization destroys any data on the disk. Table 1-3 summarizes 
the DSKINT option dialogue. Refer to Section 3.3 for complete infor- 
mation on the DSKINT option. 

3. Dismount the newly initialized disk if you need the disk drive for the 
SYSGEN system disk. 



B. Follow this procedure to initialize the SYSGEN system disk: 

• Physically mount the disk that you will use as the SYSGEN system disk. 

• Use the DSKINT option to initialize the disk as a system disk. Refer to 
Summary Table 1-3 or Section 3.3 for more information. 
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Table 1-3: Summary of DSKINT Option 



Questions and Possible Responses 



DD-MMM-YY? 

Current date. Press LINE FEED to accept the date printed. 

HH:MM? 

Current time. Press LINE FEED to accept the time printed. 

DISK? 

DF, DS, DK, DL, DM, DP, DR, DB 

UNIT? 

0-7 (asked for multi-unit controllers only). 0-3 for DL disks. 
PLATTERS (n)? 

1-8 for DF disks. Press LINE FEED to use the number in parentheses. 

(Asked for DF disks only.) 

PACK ID? 

One to six alphanumeric characters. 

PACK CLUSTER SIZE? 

1, 2, 4, 8, or 16 for RFU, RS03, RS04, RK05, RLOl, RL02, RK06, and 
RK07 disks. 2, 4, 8, or 16 for RP02 and RP03 disks. 4, 8, or 16 for RM02, 
RM03, RP04, and RP05 disks. 8 or 16 for RP06 disks. 

SATT^SYS BASE? 

A number (in blocks) from 1 to the disk size minus 1. Press LINE FEED 
to let DSKINT place SATT.SYS near the center of the disk. 

MFD PASSNORD? 

One to six alphanumeric characters. 

MFD CLUSTER SIZE? 

A power of two not less than the pack cluster size and not greater than 
16. 

PRE-EXTEND DIRECTORIES? 

Y, N. Type Y to have DSKINT extend accounts [0,1], [1,1], and [1,2] to 
the maximum size when they are created. 

PUB t PRI t OR SYS? 

PUB for a public disk. PRI for a private disk. SYS for a system disk. 

CREATE LIBRARY ACCOUNT? 

Y, N. (N skips the next three questions.) 

LIBRARY PASSNORD? 

One to six alphanumeric characters. 

LIBRARY UFD CLUSTER SIZE? 

A power of two not less than the pack cluster size and not greater than 
16. The library UFD cluster size must be at least 4 and normally is 16. 

LIBRARY ACCOUNT BASE? 

A number (in blocks) from 1 to the disk size minus 1. Press LINE FEED 
to let DSKINT place the library near the center of the disk. 



(continued on next page) 
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Table 1-3: Summary of DSKINT Option (Cont.) 



Questions and Possible Responses 



DATE LAST MODIFIED? 

Y, N. Type Y or press LINE FEED to retain in the disk directory the 
date on which files were last modified. 

NEW FILES FIRST? 

Y, N. Type N or press LINE FEED to place new files at the end of the 
directory for the account in which they were created. DIGITAL recom- 
mends this response. 

USE PREUIOUS BAD BLOCK INFO? 

Y, N. Type Y or press LINE FEED to have the new bad block file 
created using information from the existing bad block file. DIGITAL 
recommends this response. 

FORMAT? 

Y, N. Type Y to write hardware timing and sense data on the disk. 
PATTERNS? 

1-8. Append X to specify up to eight of your own patterns in addition to 

the standard patterns. 

YOUR PATTERN? 

An octal word from 1 to 177777. Press LINE FEED to indicate no more 
patterns. (Asked only if you appended X to the previous response.) 

PROCEED (Y or N)? 
Y, N 



Step 4. Copy System Files to SYSGEN Disk 

Use the COPY option to copy RSTS/E system files from the distribution 
medium to the SYSGEN system disk. After COPY transfers these files, the 
initialization code automatically bootstraps from the disk that now contains 
the RSTS/E files. Summary Table 1-4 contains questions and appropriate 
responses for the use of COPY. For further information on the COPY option, 
refer to Section 3.4. 

Table 1-4: Summary of COPY Option 



Questions and Possible Responses 



DD-MMM-YY? 

Current date. Press LINE FEED to accept the date printed. 

HHslrlM? 

Current time. Press LINE FEED to accept the time printed. 

TO WHICH DISK? 

DF, DS, DK, DL, DM, DP, DR, DB 

UNIT? 

0-7 (asked for multi-unit controllers only). 0-3 for DL disks. 
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step 5. Install Patches Required for Further Progress 

a. Gather the RSTS/E Release Notes, issues of the RSTS/E Software 
Dispatch, and any other published patches your system requires. 

b. Apply manually those patches to INIT.SYS (the initialization code), the 
SYSGEN monitor, and the RTll Run-Time System that are identified in 
the RSTS/E Release Notes or issues of the RSTS/E Software Dispatch as 
critical and indicate that they must be applied before starting the 
SYSGEN system. Follow the instructions in the published patches for 
patching the system initialization code, SYSGEN monitor, and the RTll 
Run-Time System. Refer to Section 3.5 for further information on the 
PATCH option. 

c. If the instructions in the published patch direct you to reboot the system 
after applying the patch, use the BOOT option (described in Section 3.12) 
to do so. 



Step 6. Specify SYSGEN System Hardware Characteristics 

Follow this procedure if one or both of the following conditions are true: 

• You are installing new hardware and need to ascertain the configuration. 
(Usually, DIGITAL Field Service personnel do this.) 

• At system installation, a DIGITAL Field Service representative had to 
make changes to the hardware configuration, and these changes must also 
be applied to the configuration tables you are now generating. 

Use the HARDWR option to check the hardware configuration. For new hard- 
ware, list the hardware configuration and correct it if necessary. If you are 
regenerating an existing system, make any changes necessary for this system. 
Summary Table 1-5 contains information on the HARDWR option and its 
suboptions. For complete information, refer to Section 3.6. 



Table 1-5: Summary of HARDWR Option 



Suboption 



LIST 
DISABLE 



Questions and Possible Responses 



HARDWR SUBOPTION? 

LI[ST] DKSABLE] EN[ABLE] CS[R] VE[CTOR] DM TU[58] UN[ITS] 
RE[SET] EX[IT] CTRL/C. 

You can abbreviate the suboption names to their first 2 characters. EXIT 
applies any pending changes and CTRL/C does not. Both suboptions re- 
turn you to the OPTION: prompt. Any questions that you invoke by 
specifying a particular suboption are listed and explained under the re- 
lated suboption heading. 

The LIST suboption does not ask questions. 

CONTROLLER TO DISABLE? 

Controller name. Type ? for a list of controller names. 



(continued on next page) 
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Table 1-5: Summary of HARDWR Option (Cont.) 



Suboption 



Questions and Possible Responses 



ENABLE 
CSR 



VECTOR 



DM 



TU58 



UNITS 



RESET 
HERTZ 

SWITCH 



CONTROLLER TO ENABLE? 

Controller name. Type ? for a list of controller names. 

CONTROLLER WITH NON-STANDARD ADDRESS? 
Controller name. Type ? for a list of controller names. 

NEW CONTROLLER ADDRESS? 

Type an even octal address greater than 160000. Type RE to remove a non- 
standard address. 

Type CTRL/Z to return to the HARDWR SUBOPTION question without 
specifying a new address. 

CONTROLLER WITH NON-STANDARD SECTOR? 
Controller name. Type ? for a list of controller names. 

NEW i,'ECTOR ADDRESS? 

Type an even octal address from to 774. Type RE to remove a non- 
standard vector. Type CTRL/Z to return to HARDWR SUBOPTION? 
without specifying a new vector. 

DH FOR DMn (xxx )? 

Type the DHll unit number. Press LINE FEED to accept the current 

setting of xxx. Type CTRL/Z to return to the HARDWR SUBOPTION 

question. 

DL FOR DDn (xxx)? 

Type the DLll unit number. Press LINE FEED to accept the current 

setting of xxx. Type CTRL/Z to return to the HARDWR SUBOPTION 

question. 

Specify the type of disk that will be brought on-line later. 

DISK TO SET UNITS FOR? 

Type DS, DK, DL, DM, DP, DR, DB. 

UNIT? 

0-7 (asked for multi-unit controllers only). 0-3 for DL disks. 

TYPE OF THIS UNIT? 

Type name of disk, e.g., RK06. Press LINE FEED to specify the type of 

disk currently on that unit. 

Type REMOVE to let the initialization code disable the unit whenever it 
is not found. 

DUAL-PORTED? 

Y, N. Asked only for DR or DB disks. 

INTERLEAVED? 

Y, N. Asked only for DS disks. 

The RESET suboption does not ask questions. 

NEW AC LINE HERTZ? 
Type 50 or 60. 

SWITCH REGISTER? 

Type ENABLE, DISABLE, or VOLATILE. 
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step 7. Install the SYSGEN Monitor 

Use the INSTALL option to install the SYSGEN monitor. Type SYSGEN in 
response to the question SIL? Refer to Section 3.7 for further information on 
the INSTALL option. 



Step 8. Allocate SYSGEN System Files 

Use the REFRESH option to allocate the necessary files. Summary Table 1-6 
contains questions and possible responses for this use of REFRESH. Refer to 
Section 3.8 for further information on REFRESH. 



Table 1-6: Summary of REFRESH Option 



Suboption 



LIST 
CHANGE 



Questions and Possible Responses 



DD-MMM-YY? 

Current date. Press LINE FEED to accept the date printed. 

HH:MM? 

Current time. Press LINE FEED to accept the time printed, 

DISK? 

DF, DS, DK, DL, DM, DP, DR, DB. Press the LINE FEED key to 

REFRESH the system disk. 

UNIT? 

0-7 (asked for multi-unit controllers only). 0-3 for DL disks. 

CLEAN? 

Y to clean the disk. N or LINE FEED to omit the cleaning operation. 

REFRESH SUBOPTION? 

LIST, CHANGE, FILE, or BADS. Any questions that you invoke by speci- 
fying a particular suboption are listed and explained under the related 
suboption heading. Type EXIT or press LINE FEED to return to the 
OPTION: prompt. 

The LIST suboption does not ask questions. 

f ilnatrweKt CHANGES? 

Y, N. Type CTRL/Z to return to the REFRESH SUBOPTION question. 
Asked for the following files, in this order: SWAP.SYS, SWAPO.SYS, 
SWAPl.SYS, SWAP3.SYS, OVR.SYS, ERR.SYS, BUFF.SYS, and 
CRASH.SYS. If you answer Y to FILNAM.EXT CHANGES? for any file, 
the CHANGE suboption asks the DELETE, SIZE, and BASE questions 
for that file. After you have answered the FILNAM.EXT CHANGES 
question for each of the listed files, the suboption asks the OTHER FILES 
question. 

DELETE? 

Y, N (Asked only if the file exists.) Type CTRL/Z to return to 

FILNAM.EXT CHANGES? for the current file. 



(continued on next page) 
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Table 1-6: Summary of REFRESH Option (Cont.) 



Suboption 



CHANGE 
(cont.) 



FILE 



BADS 



Questions and Possible Responses 



SIZE? 

A decimal number of blocks. For the SYSGEN system, the size of 
SWAP.SYS must be at least 224 blocks. Type CTRL/Z to return to 
FILNAM.EXT CHANGES? for the current file. For some files, such as 
OVR.SYS, ERR.SYS, BUFF.SYS, and CRASH.SYS, pressing LINE 
FEED sets an appropriate default size. 

BASE? 

The decimal number of the logical block at which you prefer to place the 
first block of the file. Type to place the file at the first available space on 
the disk. For an existing file, type OLD or press LINE FEED to retain the 
file at its current starting location, or the next available space if unable to 
place it at its current location. When creating a new file, type OLD or 
press LINE FEED to place the file at the first available space on the disk 
(same as typing 0). Type CTRL/Z to return to the FILNAM.EXT 
CHANGES question for the current file. 

OTHER FILES? 

Type a filename and extension to change another file in account [0,1]. The 
suboption then asks the DELETE, SIZE and BASE questions. Type N or 
press LINE FEED to omit changes to other files. 

FILE NAME? 
Filename and extension 

FILE EXISTS, DELETE IT? 

Y, N. Type CTRL/Z to return to the FILE NAME question. 

SIZE? 

A decimal number of blocks. Type CTRL/Z to return to the FILE NAME 

question. 

BASE? 

The decimal number of the logical block at which you prefer to place the 
first block of the file. Type to place the file at the first available space on 
the disk. For an existing file, type OLD or press LINE FEED to retain the 
file at its current starting location, or the next available space if unable to 
place it at its current location. When creating a new file, type OLD or 
press LINE FEED to place the file at the first available space on the disk 
(same as typing 0). Type CTRL/Z to return to the FILE NAME question. 

DELETABLE? 

Y, N. Press LINE FEED for no change. Type CTRL/Z to return to the 

FILE NAME question. 

BADS? 

Type LIST for a list of bad blocks in the bad block file. Type ADD to add 
bad blocks to the bad block file. Type EXIT or press LINE FEED to 
return to the REFRESH SUBOPTION question. 

BLOCK NUMBER? 

(Asked only if you answered ADD to the BADS question.) Type a logical 

block number (in decimal) between 1 and the disk size minus 1. 

REALLY ADD LOGICAL BLOCK nn TO BADB,SYS? 
Y, N 
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step 9. Set Defaults for the SYSGEN System 

Use the DEFAULT option to set system defaults. Summary Table 1-7 con- 
tains the questions and appropriate responses for use of the DEFAULT option 
for the SYSGEN system. Refer to Section 3.9 for further information on the 
DEFAULT option. 



Table 1-7: Summary of DEFAULT Option 



Questions 



JOB MAX OR SWAP MAX CHANGES? 

NEW JOB MAX? 

NEW SWAP MAX? 

RUN-TIME SYSTEM? 

ERROR MESSAGE FILE? 

INSTALLATION NAME? 

ANY MEMORY ALLOCATION CHANGES' 

TABLE SUBOPTION? 



CACHE CLUSTER SIZE <ri>? 

CRASH DUMP? 

MAGTAPE LABELLING DEFAULT? 

PREFERRED CLOCK? 

INTERRUPT FREQUENCY? 

DATE FORMAT? 
TIME FORMAT? 
POWER FAIL DELAY? 



Possible Responses 



28 

RTll 

ERR 

1-15 printable characters including spaces. 

Y, N 

LI[ST], PA[RITY], RE[SET], LO[CK], 
UN[LOCK], RT[S], XB[UF], MA[P]. You can 
abbreviate the suboption names to their first 2 
characters. Type EXIT or press LINE FEED 
to proceed to the CRASH DUMP question. 

1, 2, 4, or 8. The size in blocks of one cache 
cluster. Press LINE FEED to accept the de- 
fault value indicated by n. 

Y, N 

DOS 

P, L. Specify either Programmable Real-Time 
Clock or Line-Time Clock depending on 
system configuration. 

50-100 (multiple of 50). Asked only if you 
answer P to the previous question. 

ALPHABETIC or NUMERIC 

AM/PM or 24-HOUR 

1 to 300 



Step 10. Specify Device Unit Characteristics for the SYSGEN System 

Use the SET option to specify configuration characteristics for the SYSGEN 
monitor. Summary Table 1-8 contains the questions and possible responses 
for the SET option. Refer to Section 3.10 for further information on the SET 
option. 
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Table 1-8: Summary of SET Option 



Suboption 



Questions and Possible Responses 



LIST 



MODEM 
and LOCAL 

LP 



ENABLE 



DISABLE 



PRIV 



UNPRIV 



SET OPTION? 

LIST, MODEM, LOCAL, LP, DISABLE, ENABLE, PRIV, UNPRIV. 
Any questions that you invoke by specifying a particular suboption are 
listed and explained under the related suboption heading. Type EXIT or 
press LINE FEED to return to the OPTION: prompt. 

DEI.) ICE? 

Type a device name, device name and unit number, device name and two 
unit numbers for a range of devices (for example, KBl-6). Press LINE 
FEED to list all devices. 

KB? 

Type a decimal number between and the highest numbered keyboard or 

a range of decimal keyboard numbers. 

UNIT? 

Decimal unit number. Not asked if only one is configured. 

TYPE (XK)? 

LP, LV, LS, or LA180, or a list of characteristics. Press LINE FEED to 
accept the setting in parentheses. Press RETURN to print the characteris- 
tics associated with LP, LV, LS, and LA180. 

WIDTH (n)? 

Type a decimal number between 1 and 254 or press LINE FEED to accept 

the setting in parentheses. Common widths are 80 and 132 characters. 

LOWER CASE (x)? 

Y, N. Press LINE FEED to accept the setting in parentheses. 

DEMICE? 

Type a device name or a device name followed by unit number. Type ALL 

to enable all devices. 

UNIT? 

Type a unit number in decimal or two unit numbers separated by a 
hyphen. Type ALL to enable all units of a device. This question is not 
asked if you specify a unit number in response to the previous question. 

DEM ICE? 

Type a device name or device name followed by a unit number. 

UNIT? 

Type a unit number in decimal or two unit numbers separated by a 
hyphen. Type ALL to disable all units of a device. This question is not 
asked if you specify a unit number in response to the previous question. 

DEI,' ICE? 

Type a device name or device name followed by a unit number. 

UNIT? 

Type a unit number in decimal or two unit numbers separated by a 

hyphen. Type ALL to restrict access to all units of the device. 

DEI,' ICE? 

Type a device name or device name followed by a unit number. Type ALL 

to allow access to all devices. 

UNIT? 

Type a unit number in decimal or two unit numbers separated by a 

hyphen. Type ALL to allow access to all units of the device. 
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step 11. Start the SYSGEN System 

Use the START option to start the SYSGEN system. To invoke the option, 
type START or ST. Refer to Section 3.11 for information on start-up messages 
and errors. The SYSGEN system is configured for many devices that may not 
exist on your computer. Therefore, the initiahzation code disables the non- 
existent devices when it starts the system. 

If your distribution medium is magnetic tape, proceed to Step 13. Otherwise, 
logically mount your disk distribution medium as described in Step 12. 

Step 12. Logically Mount the Distribution Disk 

Mount your distribution medium on a free unit and ensure that it is write- 
locked. If your distribution medium is disk cartridge, type the following com- 
mand to logically mount the disk: 

•MOUNT dfluiSYSGNG/RO 

where dev is the device name and unit number on which the distribution disk 
cartridge is physically mounted. There is no need to logically mount a mag- 
netic tape distribution medium. 

Step 13. Copy Configuration Files to SYSGEN Disk 

Run the CREATE.SAV program, which includes a batch stream that trans- 
fers the SYSGEN program and several other programs to the system disk. 
Type the following command after the dot (.) prompt is printed on your 
terminal: 

•R deMiCREATE.SAV 

Substitute for dev the name of the distribution medium (MT, MS, MM, DK, 
DL, or DM) and the unit number on which it is mounted. 

Step 14. Answer System Configuration Questions 

The SYSGEN program automatically suggests answers to the configuration 
questions by printing a response (RES) in one of the three forms in Table 1-9. 

Table 1-9: Automatic Answer Formats 



Answer 



Reason 



*RES* 



The program has ascertained that RES is the correct answer. 

The program assumes that RES is the correct answer. 

The program does not know and cannot guess the correct answer. 
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Answer the configuration questions, referring to Sections 4.2 if necessary. 
Table 1-10 lists the possible responses to the configuration questions. Table 
1-11 summarizes the short form questions. 



Table 1-10: Possible Responses to Configuration Questions 



Response 



<string> 



Meaning 



<string> is the correct answer. 

Print the long, explanatory form of the question. 

Accept the automatic answer for the question. 
Not valid if the automatic answer is jfV#. 

Return to the preceding question or to the first 
question in this sequence. 



Table 1-11: Summary of Short Form Configuration Questions 



Questions and Possible Responses 



FORM? 

S, L. Answer S for short form or L for long form. Since you can always 
see the long form of the question by pressing RETURN, typing S is 
usually the best response. 

SAME SYSTEM? 

Y, N. Answer Y if you are generating a system for the current machine. 

DISTRIBUTION MEDIUM? 

MT, MS, MM, DK, DL, DM, SY. Specify the distribution medium 
type. If you are regenerating on-line, specify SY to use system genera- 
tion files already on the system disk. (If the system generation files are 
already on the system disk, they would only be there if you specified N 
to the DELETE FILES question.) 

OUTPUT MEDIUM? 

DF, DK, DL, DM, DP, DR, DB, MT, MS, MM, SY. Answer SY if the 
SYSGEN disk will be the Target disk. Otherwise, answer one of the disk 
types to specify what kind of disk the Target system will be written to, 
unless you have only one unit of that type and you are already using it 
as the SYSGEN disk. In that case specify one of the magnetic tape 
types for output of the Target system. You can later (in steps 17 and 18) 
copy the Target system files to the final disk. 

PACK ID? 

Pack ID specified when output disk was initialized. 



(continued on next page) 
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Table 1-11: Summary of Short Form Configuration Questions (Cont.) 



Questions and Possible Responses 



DELETE FILES? 

Y, N. Answer Y to delete SYSGEN system files from the SYSGEN disk 
after use. If you type N, you will be able to perform an on-line system 
generation, using SY: as your distribution medium. Type Y and some of 
the files needed to perform an on-line system generation will be deleted. 
You will then not be able to perform an on-line generation unless you 
again mount the distribution medium. 

LP FOR SYSGEN? 

Y, N. Answer Y if you want maps printed during the system generation 
process. If the answer to this question is N and the answer to DELETE 
FILES? is Y, the maps are not deleted. 

GENERATE MONITOR? 

Y, N. If N, the next question is GENERATE BASIC-PLUS? 

MONITOR NAME? 

1 to 6 alphanumeric characters. The RSTS/E Monitor Save Image 
Library (SIL) file has the extension .SIL. Do not type the name of a 
SIL that is already on the Target disk. 

ASSEMBLY LISTINGS? 

Y, N. Asked only if the answer to LP FOR SYSGEN? is Y. The auto- 
matic answer is Y if the answer to DELETE FILES? is Y. 

MONITOR PATCHING? 

Y, N. If answer is N, next three questions are skipped. 

PATCH FILE MEDIUM? 

DK, DL, DM, DP, DR, DB, MT, MS, MM, SY. Specify distribution 
medium or device type where the patch files are contained. 

PACK ID? 

Pack ID of patch file disk. Asked only when PATCH FILE MEDIUM is 
disk. 

PATCH FILE NAME? 

File specification. Default is: $MONITR.CMD. 

GENERATE BASIC-PLUS? 

Y, N. If you answer N, the next question is RSX AS DEFAULT RTS. 

BASIC-PLUS RTS NAME? 

1 to 6 alphanumeric characters. BASIC-PLUS Run-Time System file 
has the extension .RTS. Do not type the name of a run-time system that 
is already on the Target disk. 

BASIC-PLUS PATCHING? 

Y, N. If answer is N, next three questions are skipped. 



(continued on next page) 
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Table 1-11: Summary of Short Form Configuration Questions (Cont.) 



Questions and Possible Responses 



PATCH FILE MEDIUM? 

DF, DS, DK, DL, DM, DP, DR, DB, MT, MS, MM, SY. Specify distri- 
bution medium or device type where the patch files are contained. 

PACK ID? 

Pack ID of patch file disk. Asked only when PATCH FILE MEDIUM is 
disk. 

PATCH FILE NAME? 

File specification. Default is: $BASIC.CMD. 

RSX AS DEFAULT RTS? 

Y, N. If N, the next question is KLll, LCll, DLllA, DLllB'S. Type Y 
if you want RSX or BASIC-PLUS-2 (BP2C0M) as system default run- 
time system. 

RSX PATCHING? 

Y, N. If you answer N, the next three questions are skipped. 

PATCH FILE MEDIUM? 

DK, DL, DM, DP, DR, DB, MT, MS, MM, or SY. Specify distribution 
medium or device type where patch files are contained. 

PACK ID? 

Pack ID of patch file disk. Asked only when PATCH FILE MEDIUM is 
disk. 

PATCH FILE NAME? 

File specification. Default is $RSXRTS.CMD. 

KLll f LCll f DLllA f DLllB'S? 

1 to 16. Include the console terminal in your count. 

DLllC f DLllD'S 

to 31. Do not inlcude DLll's used to interface TU58 DECtape II 
controllers. 

to 32 

DLllE'S? 

to 31. After this question, SYSGEN returns to the KLll, LCll, 
DLllA, DLllB'S question if you have configured any combination of 
DLllC, DLllD, or DLllE interfaces that total more than 31. 

DJll 'S 

to 16. If you answer 0, the next question is DHll'S. 

DJll UNIT KX LINES ENABLED? 

to 16. SYSGEN repeats this question for each DJll unit configured. 



(continued on next page) 
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Table 1-11: Summary of Short Form Configuration Questions (Cont.) 



Questions and Possible Responses 



DHll'S? 

to 16. If you answer 0, the next question is DZll'S. 

DHll UNIT XX LINES ENABLED? 

to 16. SYSGEN repeats this question for each DHll unit configured. 

DATASET SUPPORT FOR DHll 'S? 
Y, N 

DZll 'S 

to 16. If you answer 0, the next question is PSEUDO KEYBOARDS. 

DZll UNIT XX LINES ENABLED? 

to 8. SYSGEN repeats this question for each DZll unit configured. 

DATASET SUPPORT FOR DZll 'S? 
Y, N 

PSEUDO KEYBOARDS? 

1 to 127. If you have configured more than 128 terminals (including the 
console terminal and pseudo keyboards), SYSGEN returns to the KLll, 
LCll, DLllA, DLllB'S question. 

27^1 SUPPORT? 

Y, N. Asked only if you configured one or more DLllD, DLllE, DCll, 
DHll, or DZll interfaces. If you answer N, SYSGEN goes to the 
MULTI-TERMINAL SERVICE question. 

SINGLE LINE 27^1 SUPPORT? 

Y, N. Asked only if you configured DLllD, DLllE, or DCll interfaces. 

2741 SUPPORT ON DH'S? 

Y, N. Asked only if you configured one or more DHll'S. 

2741 SUPPORT ON DZ'S? 

Y, N. Asked only if you configured one or more DZll'S. 

2741 CODES(S)? 

CORR, EBCD, SBCD, C360. Any combination of the four codes is legal. 

MULTI-TERMINAL SERMICE? 
Y, N 

ECHO CONTROL? 
Y, N 

ONE-LINE STATUS REPORT? 

Y, N. Type Y to include "Mini-SYSTAT" option. The current job state 
can then be displayed during time sharing by typing CTRL/T. 

RF/RSll 'S? 
Y, N 



(continued on next page) 
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Table 1-11: Summary of Short Form Configuration Questions (Cont.) 



Questions and Possible Responses 



RS03/RB0a'S? 
to8 

RKOS'S? 

to 8. If the controller exists, the automatic answer is 8. If the answer is 
or 1, SYSGEN skips the next question. Remember to count RK05F 
disks as two RK05 units. 

OMERLAPPED SEEK? 

Y, N. Type Y to use the overlapped seek driver to increase the efficiency 
of disk I/O at the expense of some memory. 

RL01/RL02'S? 

to 4. If you answer or 1, SYSGEN skips the next question. 

OMERLAPPED SEEK? 

Y, N. Type Y to use the overlapped seek driver to increase the efficiency 
of disk I/O at the expense of some memory. 

RK0B/RK07'S 

to 8. If you answer or 1, SYSGEN skips the next question. 

OMERLAPPED SEEK? 

Y, N. Type Y to use the overlapped seek driver to increase the efficiency 
of disk I/O at the expense of some memory. 

R P 2 / R P 3 ' S ? 

to 8. If the controller exists, the automatic answer is 8. If you answer 
or 1, SYSGEN skips the next question. 

OMERLAPPED SEEK? 

Y, N. Type Y to use the overlapped seek driver to increase the efficiency 
of disk I/O at the expense of some memory. 

RM02/RM03'S 

to 8. If you answer or 1, SYSGEN skips the next question. 

OMERLAPPED SEEK? 

Y, N. Type Y to use the overlapped seek driver to increase the efficiency 
of disk I/O at the expense of some memory. 

RP0a/RP05/RP0G'S? 

to 8. If you answer or 1, SYSGEN skips the next question. 

OMERLAPPED SEEK? 

Y, N. Type Y to use the overlapped seek driver to increase the efficiency 
of disk I/O at the expense of some memory. 

TU16/TE1G/TU45/TU77'S? v 

to 8. If the controller exists, the automatic answer is 8. 



(continued on next page) 
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Table 1-11: Summary of Short Form Configuration Questions (Cont.) 



Questions and Possible Responses 



TU10/TE10/TS03'S? 

to 8. If the controller exists, the automatic answer is 8. 

ISDN'S 
0to8 

DECTAPES? 

to 8. If the controller exists, the automatic answer is 8. 

TUSB'S 

to 8. If the controller exists, the automatic answer is 8. 

PRINTERS? 
to 8 

R)<01/R)<02'S 

to 8. If a controller exists, the automatic answer is 8. 

CRll/CMll CARD READER? 
Y, N 

CDll CARD READER? 
Y, N 

CARD DECODE? 

029, 026, 1401, ANSI. SYSGEN skips this question if you answered N to 
the two previous questions. 

P«T, READER? 

Y, N 

P»T» PUNCH? 
Y, N 

DMCll 'S? 

to 8. If you answer 0, SYSGEN skips the next six questions. 

DECNET NETWORK SUPPORT? 

Y, N. If you answer N, SYSGEN skips the next two questions. 

DECNET/E DISTRIBUTION MEDIUM? 

MT, MS, MM, DK, DL, DM, SY. Indicate /A after device name to 
specify DECnet/E VI. 0; otherwise, DECnet/E VI. 1 is assumed. 

DECNET/E PATCHING? 

Y, N. SYSGEN skips the next three questions if you answer N to this 
question. 

PATCH FILE MEDIUM? 

DF, DS, DK, DL, DM, DP, DR, DB, MT, MS, MM, SY. Specify distri- 
bution medium or device type where patch files are contained. 
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Table 1-11: Summary of Short Form Configuration Questions (Cont.) 



Questions and Possible Responses 



PACK ID? 

Pack ID of patch file disk. Asked only when patch file medium is disk. 

PATCH FILE NAME? 

File Specification. Default is: $DECNTB.CMD or $DECNTA if you 
specified /A to the DISTRIBUTION MEDIUM question. 

KMCli 's 

0-16. If 0, the next two questions are skipped. 

KMC IBM PROTOCOL SUPPORT? 

Y, N. If you answer N, the next question is skipped. 

SIMULTANEOUS LINKS? 

to 16. Asked only if you typed Y to the KMC IBM PROTOCOL 
question. Each KMCll can control one DUPll synchronous line inter- 
face to the 3271 host. Specify the number of simultaneous KMC/3271 
links you want. 

EXTENDED BUFFERING FOR LP? 

Y, N. Asked only if you answered 1 or more to the PRINTERS question. 

2780 SUPPORT? 

Y, N. If you answer N, SYSGEN skips the next five questions. Answer 
Y if you are using the RSTS/2780 software. 

2780 INTERFACE? 
DP, DU, DUP 

2780 DISTRIBUTION MEDIUM? 
MT, MS, MM, DK, DL, DM, SY 

2780 PATCHING? 

Y, N. If you answer N, SYSGEN skips the next two questions. 

PATCH FILE MEDIUM? 

DF, DS, DK, DL, DM, DP, DR, DB, MT, MS, MM, SY. Specify distri- 
bution medium or device type where patch files are contained. 

PATCH FILE NAME? 

File specification. Default is: $RJ2780.CMD. 

LARGE FILES 

Y, N. Answer Y if you want support of files larger than 65535 blocks. 

MAXIMUM JOBS? 

1 to 63 

SMALL BUFFERS? 

30 to 999. The automatic answer is 9 times the configured job maximum 
plus 80, but no more than 500. 



(continued on next page) 
System Generation Overview 1-29 



Table 1-11: Summary of Short Form Coni^guration Questions (Cont.) 



Questions and Possible Responses 



SYSTEM NIDE LOGICALS? 
5 to 50 

MONITOR STATISTICS? 

Y, N. Answer Y to include the Monitor Statistics Code. 

FIP BUFFERING? 

Y, N. Type Y to generate directory caching for your system. If you 
answer N, SYS GEN skips the next question. 

EXTENDED DATA BUFFERING? 

Y, N. Answer Y to allow data files to be placed in the system's data 
buffer (cache). 

DISK DRIMER PHASE? 

Y, N. Answer Y to put disk drivers into a separate phase of the monitor. 

RESIDENT LIBRARIES? 

Y, N. Answer Y to support resident libraries, such as RMS. 

RSX DIRECTIVES? 

Y, N. Type Y to include monitor emulation of RSX directives, which 
are required for support of the RMS Resident Libraries. 

RESIDENT DISK HANDLING? 

Y, N 

RESIDENT SEND/RECEIME? 

Y, N. If DECnet/E is included this question is skipped. 

RESIDENT SIMPLE SYS CALLS? 

Y, N . 

RESIDENT FILE DELETE/RENAME? 
Y, N 

RESIDENT LOG IN/ ATTACH/ ATTRIBUTE? 
Y, N 

RESIDENT CATALOG/LOOKUP? 

Y, N 

The remaining questions are asked only when you are generating 
BASIC-PLUS. 

FP P? 

Y, N. If you answer Y, SYS GEN skips the next question. 

FIS? 
Y, N 



(continued on next page) 



1-30 System Generation Overview 



Table 1-11: Summary of Short Form Configuration Questions (Cont.) 



Questions and Possible Responses 



MATH PRECISION? 
2,4 

LOG FUNCTIONS? 
Y, N 

TRIG FUNCTIONS? 
Y, N 

PRINT USING? 
Y, N 

MATRICES? 
Y, N 

STRING ARITHMETIC? 
Y, N 



Step 15. Generate (and Patch) Target Monitor and Default Run-Time System 

A. Type the following command to start the execution of the batch process: 

»RSYSBAT 

B., When the batch processor asks you to mount a disk or tape, or to enable a 
line printer, do so. Answer its UNIT question by typing the unit number on 
which you mounted the disk or tape or the unit number of the line printer 
you enabled. Only line printer unit is legal, and only units and 1 of 
magnetic tapes and disks are legal, except that DK units 0-3 are legal. 

A control file (SYSGEN.CTL) was created as a result of your responses to the 
configuration dialogue questions that are described in Table 1-11. SYSBAT is 
a batch processor that will now process this control file and subsequently print 
a log of the batch stream on your terminal. 

Step 16. Shut Down the SYSGEN System 

Run the UTILTY program and issue the NO LOGINS and SHUTUP com- 
mands, as follows: 

.R UTILTY. SAV 
*H0 LOGINS 
#SHUTUP 

The shutdown procedure automatically loads and bootstraps the system 
initialization code from the current system device. Remove the distribution 
medium and store it in a safe place. 
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Step 17. Bootstrap the Device Containing the Target System IVIonltor 

Follow this procedure only if the batch stream wrote the Target system moni- 
tor on a device other than the SYSGEN system disk. 

Use the BOOT initialization option to bootstrap the initialization code from 
the device containing the Target system monitor. Respond to the BOOT 
option prompt as follows: 

BOOT DEUICE: xxn 

Substitute the two character mnemonic of the device that contains the Target 
monitor for xx and the unit number on which it is mounted for n. 

Step 18. Initialize, then Copy Files to Target Disl( 

Follow this procedure only if the batch stream wrote the Target system moni- 
tor on a magnetic tape or on a disk (intermediate Target medium) that is 
different from the Target system disk (final Target disk) and you 
bootstrapped it as described in step 17. 

A. If you have not already initialized the Target system disk, use the 
DSKINT option now to do so. Summary Table 1-12 contains the DSKINT 
question and possible responses. Refer to Section 3.3 for further informa- 
tion on DSKINT. 

B. Use the COPY option to copy the Target system files from the intermedi- 
ate Target tape or disk to the final Target system disk. Summary Table 
1-13 contains the COPY option questions and possible responses. 

To copy all run-time systems from the system tape or disk to the Target 
system disk you must type: dev/A in reponse to the COPY option question: 
TO WHICH DISK? 

Table 1-12: Summary of DSKINT Option 



Questions and Possible Responses 



DD-MMM-YY? 

Current date. Press LINE FEED to accept the date printed. 

HH:MM? 

Current time. Press LINE FEED to accept the time printed. 

DISK? 

DF, DS, DK, DL, DM, DP, DR, DB 

UNIT? 

0-7 (asked for multi-unit controllers only). 0-3 for DL disks. 

PLATTERS(ri)? 

1-8 for DF disks. Press LINE FEED to use the number in parentheses. 
(Asked for DF disk only.) 



(continued on next page) 
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Table 1-12: Summary of DSKINT Option (Cont.) 



Questions and Possible Responses 



PACK ID? 

One to six alphanumeric characters. 

PACK CLUSTER SIZE? 

1, 2, 4, 8, or 16 for RF11,RS03, RS04, RK05, RLOl, RL02, RK06, and 
RK07 disks. 2, 4, 8, or 16 for RP02 and RP03 disks. 4, 8, or 16 for RM02, 
RM03, RP04 and RP05 disks. 8 or 16 for RP06 disks. 

SATT»SYS BASE? 

A number (in blocks) from 1 to the disk size minus 1. Press LINE FEED 
to let DSKINT place SATT.SYS near the center of the disk. 

MFD PASSNORD? 

One to six alphanumeric characters. 

MFD CLUSTER SIZE? 

A power of two not less than the pack cluster size and not greater than 
16. 

PRE-EXTEND DIRECTORIES? 

Y, N. Type Y to have DSKINT extend accounts [0,1], [1,1], and [1,2] to 
their maximum size when they are created. 

PUB f PRI f OR SYS? 

PUB for public disk. PRI for private disk. SYS for system disk. 

CREATE LIBRARY ACCOUNT? 

Y, N. (N skips the next three questions.) 

LIBRARY PASSNORD? 

One to six alphanumeric characters. 

LIBRARY UFD CLUSTER SIZE? 

A power of two not less than the pack cluster size and not greater than 
16. The library UFD cluster size must be at least 4 and is normally 16. 

LIBRARY ACCOUNT BASE? 

A number (in blocks) from 1 to the disk size minus 1. Press LINE FEED 
to let DSKINT place the library near the center of the disk. 

DATE LAST MODIFIED? 

Y, N. Type Y or press LINE FEED to retain in the disk directory the 
data on which files were last modified. 

NEW FILES FIRST? 

Y, N. Type N or press LINE FEED to place new files at the end of the 
directory for the account in which they were created. DIGITAL recom- 
mends this response. 



(continued on next page) 
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Table 1-12: Summary of DSKINT Option (Cont.) 



Questions and Possible Responses 



FORMAT? 

Y, N. Type Y to write hardware timing and sense data on the disk. 

PATTERNS? 

1-8. Append X to specify up to eight of your own patterns in addition to 
the standard patterns. 

YOUR PATTERN? 

An octal word from 1 to 177777. Press LINE FEED to indicate no more 
patterns. (Asked only if you appended X to the previous response.) 

PROCEED (Y or N)? 
Y, N 



Table 1-13: Summary of COPY Option 


Questions and Possible Responses 


DD-MMM-YY? 




Current date. 


Press LINE FEED to accept the date printed. 


HH:MM? 




Current time. 


Press LINE FEED to accept the time printed. 


TO WHICH DISK 


"p 


DF, DS, DK, 


DL, DM, DP, DR, DB 


UNIT? 




0-7 (asked for multi-unit controllers only). 0-3 for DL disks. 



Step 19. Specify Console Fill Factor and IHardware Characteristics for Target 
Dlsl( 

Follow the procedures in this step only if the batch stream wrote the Target 
system monitor on a device other than the SYSGEN system disk. 

A. If necessary, use the FILL option to set the console terminal fill character- 
istics. Summary Table 1-14 contains the possible fill characteristics. Refer 
to Section 3.15 for further information on the FILL option. 

B. If the DIGITAL field service engineer who installed your system informed 
you of any necessary hardware controller changes, use the HARDWR op- 
tion to make those changes. Summary Table 1-15 contains the HARDWR 
option questions and possible responses. Refer to Section 3.6 for further 
information on the HARDWR option. 
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Table 1-14: Recommended Console Terminal Fill Characteristics 



Fill 
Characteristic 


Terminal 




1 

3 

LA30S 


ASR33, KSR33, VT05, LA30, 
VT50, VT52, LA36, VTIOO, 
LA120, LA34, LA38 

ASR35, KSR35 

VT05B 

LA30S 



Table 1-15: Summary of HARDWR Option 



Suboption 



Questions and Possible Responses 



LIST 
DISABLE 

ENABLE 

CSR 



VECTOR 



DM 



TU58 



HARDWR SUBOPTION? 

LI[ST], DKSABLE], EN[ABLE], CS[R], VE[CTOR], TU[58], DM, UN[ITS], 
RE[SET], EX[IT], CTRL/C. You can abbreviate the names to their first 2 
characters. EXIT applies all pending changes and CTRL/C does not; both 
return you to the OPTION: prompt. Any questions that you invoke by 
specifying a particular suboption are listed and explained under the related 
suboption heading. 

The LIST Suboption does not ask questions. 

CONTROLLER TO DISABLE? 

Controller name. Type ? for a list of controller names. 

CONTROLLER TO ENABLE? 

Controller name. Type ? for a list of controller names. 

CONTROLLER WITH NON-STANDARD ADDRESS? 
Controller name. Type ? for a list of controller names. 

NEW CONTROLLER ADDRESS? 

Type an even octal address greater than 160000. Type REMOVE to remove a 
non-standard address. Type CTRL/Z to return to HARDWR SUBOPTION? 
without specifying a new address. 

CONTROLLER WITH NON-STANDARD SECTOR? 
Controller name. Type ? for a list of controller names. 

NEW VECTOR ADDRESS? 

Type an even octal address from to 774. Type REMOVE to remove a non- 
standard vector. Type CTRL/Z to return to HARDWR SUBOPTION? with- 
out specifying a new vector. 

DH FOR DMri(xHx)? 

Type the DHll unit number. Press LINE FEED to accept the current 

setting of xxx. Type CTRL/Z to return to the HARDWR SUBOPTION 

question. 

DL FOR DDn (xxx)? 

Type the DLll unit number. Press LINE FEED to accept the current 

setting of xxx. Type CTRL/Z to return to the HARDWR SUBOPTION 

question. 



(continued on next page) 
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Table 1-15: Summary of HARDWR Option (Cont.) 



Suboption 



UNITS 



RESET 
HERTZ 

SWITCH 



Questions and Possible Responses 



Specify the type of disk that will be brought on-line later. 

DISK TO SET UNITS FOR? 

Type DS, DK. DL, DM, DP, DR, DB. 

UNIT? 

Type 0-7 (asked for multi-unit controllers only). 0-3 for DL disks. 

TYPE OF THIS UNIT? 

Type name of disk, e.g., RK06. Press LINE FEED to specify the type of disk 

currently on that unit. 

DUAL-PORTED? 

Y, N. Asked only for DR or DB disks. 

INTERLEAVED? 

Y, N. Asked only for DS disks. 

RESET does not ask questions. 

NEW AC LINE HERTZ? 
Type 50 or 60. 

SWITCH REGISTER? 

Type ENABLE, DISABLE, or VOLATILE. 



Step 20. Install the Target Monitor 

Use the INSTALL option to install the Target monitor. In response to the SIL 
question, type the name you specified to the MONITOR NAME configuration 
question. Refer to Section 3.7 for further information on the INSTALL option. 

Step 21 . Allocate Target System Files 

Use the REFRESH option to ensure that system files are correctly allocated. 
If the SYSGEN and Target disks are the same, you may need only to list the 
file status table to be sure of the allocation. If the batch process wrote the 
Target system on another device, you must now allocate and position all files 
on the Target system. Summary Table 1-16 contains the REFRESH option 
questions and responses. Refer to Section 3.8 for further information on the 
REFRESH option. 

Table 1-16: Summary of REFRESH Option 



Suboption 



Questions and Possible Responses 



DD-MMM-YY? \ 

Current date. Press LINE FEED to accept the date printed. 

HH:MM? 

Current time. Press LINE FEED to accept the time printed. 

D I SK '^ 

DF, DS, DK, DL, DM, DP, DR, or DB. Press LINE FEED to REFRESH 

the system disk. 



(continued on next page) 
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Table 1-16: Summary of REFRESH Option (Cont.) 



Suboption 



Questions and Possible Responses 



LIST 
CHANGE 



FILE 



UNIT? 

0-7 (asked for multi-unit controllers only). 0-3 for DL disks. 

CLEAN? 

Y to clean the disk. Type N or press LINE FEED to omit the cleaning 

operation. 

REFRESH SUBOPTION? 

LI[ST], CH[ANGE], FI[LE], or BA[DS]. Type EXIT or press LINE FEED to 

return to the OPTION: prompt. 



The LIST suboption does not ask questions. 

f ilnam.ext CHANGES? 

Y, N. Type CTRL/Z to return to the REFRESH SUBOPTION question. 
Asked for the following files, in this order: SWAP.SYS, SWAPO.SYS, 
SWAPl.SYS, SWAP3.SYS. OVR.SYS, ERR.SYS, BUFF.SYS, and 
CRASH.SYS. If you answer Y to FILNAM.EXT CHANGES? for any file, 
the CHANGE suboption asks the DELETE, SIZE, and BASE, questions for 
that file. After you have answered the FILNAM.EXT CHANGES queston 
for each of the listed files, the suboption asks the OTHER FILES question. 



DELETE? 

Y, N. (Asked only if the file exists.) Type 

FILNAM.EXT CHANGES? for the current file. 



CTRL/Z to return to 



SIZE? 

A decimal number of blocks. Type CTRL/Z to return to FILNAM.EXT 

CHANGES? for the current file. 

BASE? 

The decimal number of the logical block at which you prefer to place the 
first block of the file. Type to place the file at the first available space on 
the disk. For an existing file, type OLD or press LINE FEED to retain the 
file at its current starting location, or the next available space if unable to 
place it at its current location. When creating a new file, type OLD or press 
LINE FEED to place the file at the first available space on the disk (same 
as typing 0). Type CTRL/Z to return to the FILNAM.EXT CHANGES 
question for the current file. 

OTHER FILES? 

Type a filename and extension to change another file in account [0,1], The 
suboption then asks the DELETE, SIZE, and BASE questions. Type N or 
press LINE FEED to omit changes to other files. 

FILE NAME? 
Filename and extension. 

FILE EXISTS* DELETE IT? 

Y, N. Type CTRL/Z to return to the FILE NAME question. 

SIZE? 

A decimal number of blocks. Type CTRL/Z to return to the FILE NAME 

question. 
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Table 1-16: Summary of REFRESH Option (Cont.) 



Suboption 



Questions and Possible Responses 



FILE 
(cont.) 



BADS 



BASE? 

The decimal number of the logical block at which you prefer to place the 
first block of the file. Type to place the file at the first available space on 
the disk. For an existing file, type OLD or press LINE FEED to retain the 
file at its current starting location, or the next available space if unable to 
place it at its current location. When creating a new file, type OLD or press 
LINE FEED to place the file at the first available space on the disk (same 
as typing 0).Type CTRL/Z to return to the FILE NAME question. 

DELETABLE? 

Y, N. Press LINE FEED for no change. Type CTRL/Z to return to the FILE 

NAME question. 

BADS? 

Type LIST for a list of bad blocks in the bad block file. Type ADD to add 
bad blocks to the bad block file. Type EXIT or press LINE FEED to return 
to the REFRESH SUBOPTION question. 

BLOCK NUMBER? 

(Asked only if you answered ADD to the BADS question.) Type a logical 

block number (in decimal) between 1 and the disk size minus 1. 

REALLY ADD LOGICAL BLOCKnn TO BADB.SYS? 
Y, N 



Step 22. Set Defaults for the Target System 

Use the DEFAULT option to set defaults for the new monitor. Summary 
Table 1-17 contains DEFAULT option questions and responses. Refer to 
Section 3.9 for further information on the DEFAULT option. 



Table 1-17: Summary of DEFAULT Option 



Suboption 


Questions and Possible Responses 




JOB MAX OR SWAP MAX CHANGES? 
Y, N 

NEW JOB MAX? 

Decimal number from 1 to configured job maximum. 

NEW SWAP MAX? 

8 to 31. Allocate at least 16K words. 

RUN-TIME SYSTEM? 

Name of the run-time system that you prefer as the system default. 

ERROR MESSAGE FILE? 

Name of the error message file that you prefer as the system 

default. 

INSTALLATION NAME? 

1-15 printable characters including spaces. 



(continued on next page) 
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Table 1-17: Summary of DEFAULT Option (Cont.) 



Suboption 


Questions and Possible Responses 




ANY MEMORY ALLOCATION CHANGES? 
Y, N 




TABLE SUBOPTION? 

LI[ST], PA[RITY], RE[SET], LO[CK], UNILOCK], RT[S], 
XB[UF], MA[P]. You can abbreviate the suboption names to their 
first 2 characters. Type EXIT or press LINE FEED to proceed to 
the CRASH. DUMP question. Any questions that you may invoke 
by specifying a particular suboption are listed and explained under 
the related suboption heading. 


LIST, PARITY, and 
RESET 


These suboptions do not ask any questions. 


LOCK 


LOCK ADDRESS IS? 
Address or range of addresses.* 


UNLOCK 


UNLOCK ADDRESS IS? 
Address or range of addresses.* 


RTS 


NEW RUN TIME SYSTEM ADDRESS IS? 
Starting address.* 


XBUF 


EXTENDED BUFFER SPACE ADDRESS RANGE IS? 
Address or range of adresses.* 


MAP 


SIZE OF MAPPED XBUF(N)K? 
Zero to size of XBUF in K words. 




CACHE CLUSTER SIZE < n > 

1, 2, 4, or 8. The size in blocks of one cache cluster. Press LINE 

FEED to accept the default value indicated by n. 




CRASH DUMP? 
Y, N 




MAGTAPE LABELLING DEFAULT? 

If the distribution medium is magnetic tape, type DOS. If the 

distribution medium is disk, type DOS or ANSI. 




PREFERRED CLOCK? 

P, L. Specify either Programmable Real-Time Clock or Line-Time 

Clock depending on system configuration. 




INTERRUPT FREQUENCY? 

50-1000 (multiple of 50). Asked only if you answer P to the 

previous question. 




DATE FORMAT? 
ALPHABETIC or NUMERIC. 




TIME FORMAT? 
AM/PM or 24-HOUR. 




POWER FAIL DELAY? 
1 to 300 


*An address typed in r 
address or as a decirr 
type two addresses in 
decimal size in K 
00130000-00137777, 1 


ssponse to these questions can be expressed either as an absolute octal 
lal integer followed by the letter K. To specify a range of addresses, 
either format, separated by a hyphen, or an address, a plus sign, and 
L words. Legal addresses are, for example, 00577777, 21K, 
8K+6, and 18K-23K. 
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Step 23. Specify Target Device Unit Ciiaracteristics 

Use the SET option to set modem control for keyboards, enable and disable 
device units, establish line printer characteristics, and set device assignment 
privileges. Summary Table 1-18 contains SET option questions and possible 
responses. Refer to Section 3.10 for further information on the SET option. 



Table 1-18: Summary of SET Option 



Suboption 



LIST 



MODEM and 
LOCAL 

LP 



ENABLE 



DISABLE 



Questions and Possible Responses 



SET SUBOPTION? 

LI[ST], MO [DEM], LO[CAL], LP, DI[SABLE], EN [ABLE], PR[IV], 
UN[PRIV]. You can abbreviate the suboption names to their first 2 char- 
acters. Type EXIT or press LINE FEED to return to the OPTION: 
prompt. 

DEVICE? 

Type a device name, device name and unit number, device name, and 
two unit numbers for a range of devices (for example, KBl-6). Press 
LINE FEED to list all devices. 

KB? 

Type a decimal number between and the highest numbered keyboard 

or a range of decimal keyboard numbers. 

UNIT? 

Decimal unit number. Not asked if only one is present. 

TYPE ( XX )? 

LP, LV, LS, or LA180 or a list of characteristics. Press LINE FEED to 
accept the setting in parentheses. Press RETURN to print the character- 
istics associated with LP, LV, LS, and LA180. 

WIDTH(n)? 

Type a decimal number between 1 and 254 or press LINE FEED 

to accept the setting in parentheses. Common widths are 80 and 132 

columns. 

LOWER CASE (x)? 

Y, N. Press LINE FEED to accept the setting in parentheses. 

DEVICE? 

Type a device name or a device name followed by unit number. Type 

ALL to enable all devices. 

UNIT? 

Type a unit number in decimal or two unit numbers separated by a 
hyphen. Type ALL to enable all units of a device. This question is not 
asked if you specify a unit number in response to the previous question. 

DEVICE? 

Type a device name or device name followed by a unit number. 

UNIT? 

Type a unit number in decimal or two unit numbers separated by a 
hyphen. Type ALL to disable all units of a device. This question is not 
asked if you specify a unit number in response to the previous question. 



(continued on next page) 
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Table 1-18: Summary of SET Option (Cont.) 



Suboption 



PRIV 



UNPRIV 



Questions and Possible Responses 



DEVICE? 

Type a device name or device name followed by a unit number. 

UNIT? 

Type a unit number in decimal or two unit numbers separated by a 

hyphen. Type ALL to restrict access to all units of the device. 

DEVICE? 

Type a device name or device name followed by a unit number. Type 

ALL to allow access to all devices. 

UNIT? 

Type a unit number in decimal or two unit numbers separated by a 

hyphen. Type ALL to allow access to all units of the device. 



Step 24. Start the Target System 

Use the START option to start time sharing. The START option asks several 
of the DEFAULT option questions. When you answer these questions, you can 
override the defaults for the current time-sharing session. These questions are 
summarized with the DEFAULT questions in Table 1-19. Refer to Section 
3.11 for further information on the START option. 

Table 1-19: Summary of DEFAULT Option 



Suboption 


Questions and Possible Responses 




JOB MAX OR SWAP MAX CHANGES? 

Y, N. If you answer NO, the next two questions are skipped. 

NEW JOB MAX? 

Decimal number from 1 to the configured job maximum. 

NEW SWAP MAX? 

8 to 31. Specify at least 16K words; however, if you included RSX 
monitor emulation during the configuration dialogue, then you 
should specify 31K words. 

RUN-TIME SYSTEM? 

Name of the run-time system that you prefer as the system default. 

ERROR MESSAGE FILE? 

Name of the error message file that you prefer as the system 

default. 

INSTALLATION NAME? 

1-15 alphanumeric characters including spaces. 

ANY MEMORY ALLOCATION CHANGES? 

Y, N. If you answer N, the next question is CRASH DUMP. 

TABLE SUBOPTION? 

LI[ST], PA[RITY], RE[SET], LO[CK], UN[LOCK], RT[S], 
XB[UF], MA[P]. You can abbreviate the suboption names to their 
first 2 characters. Type EXIT or press LINE FEED to proceed to 
the CRASH DUMP question. 



(continued on next page) 
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Table 1-19: Summary of DEFAULT Option (Cont.) 



Suboption 



LIST, PARITY, and 
RESET 

LOCK 

UNLOCK 

RTS 

XBUF 

MAP 



Questions and Possible Responses 



This suboption does not ask any questions. 

LOCK ADDRESS IS? 
Address or range of addresses.* 

UNLOCK ADDRESS IS? 
Address or range of addresses.* 

NEW RUN TIME SYSTEM ADDRESS IS? 
Starting address.* 

EXTENDED BUFFER SPACE ADDRESS RANGE IS? 
Address or range of adresses.* 

SIZE OF MAPPED )(BUF(N)K? 
Zero to size of XBUF in K words, 

CACHE CLUSTER SIZE <ri>? 

1, 2, 4, or 8. The size in blocks of one cache cluster. Press LINE 

FEED to accept the default value indicated by n. 



CRASH DUMP? 




Y, N 




MAGTAPE LABELLING 


DEFAULT? 


Type DOS or ANSI. 




PREFERRED CLOCK? 




P, L 





DATE FORMAT? 
ALPHABETIC or NUMERIC. 

TIME FORMAT? 
AM/PM or 24-HOUR. 

POWER FAIL DELAY? 
1 to 300 



*An address typed in response to any of these questions can be expressed either as an 
absolute octal address or as a decimal integer followed by the letter K. To name a range of 
addresses, type two addresses in the specified format, separated by a hyphen, or an 
address, a plus sign, and decimal size in K words. Legal addresses are, for example, 
00577777, 21K, 00130000-00137777, 18K+6, and 18K-23K. 



Step 25. Transfer Files to Target Disk 

You may have decided earlier in the system generation procedure to place the 
Target system on an intermediate disk or magnetic tape. This means you 
generated the Target system on a medium that you planned not to be your 
final Target system medium. There are times when it is advantageous to 
generate the Target system onto magnetic tape or a small disk (RK05), then 
transfer it to your final Target medium, often a larger disk. Follow these 
procedures only if you created an intermediate Target system on disk or 
magnetic tape. You must now transfer the information to the final Target 
medium. 
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step 25A. Mount the Intermediate Target Medium. 

1. If the Target medium is magnetic tape, mount it and go to Step 25B. 

2. If the Target medium is disk, physically mount, then logically mount the 
disk using the following command: 

MOUNT deu!PacKid/RO 

where dev is the device name and unit number of the intermediate Target 
disk. Go to Step 25B. 

Step 25B. Run the MINCOP Program. 

Type RUN dev:$MINCOP, then press RETURN. MINCOP begins to transfer 
the files and prints copy messages on the console terminal to indicate the 
successful completion of each copy procedure. 

Step 26. Mount Autopatch Distribution Medium 

Refer to Section 6.4. 

Step 27. Copy Patches to Target DIslc's Public Structure 

Refer to Section 6.4. 

Follow this procedure if the autppatch distribution medium is tape or disk 
that will not be mounted during the BUILD procedure. 

Step 28. BUILD and PATCH System Default Run-Time System 

Follow this procedure if the default run -time system is not BASIC-PLUS. 

A. Mount, build, and patch RSX.RTS. 

B. If the default run-time system will be BASIC-PLUS-2, then mount, build, 
and patch BASIC-PLUS-2. If not, proceed to Step 29. 

Refer to Section 6.5. 

Step 29. Mount the System Library Distribution Medium 

A. For magnetic tape distribution: 

Ensure that the write enable ring is removed. 

Mount the magnetic tape on a free unit. 

Ensure that the BOT and FILE PROT indicators are lit. 

Set the ON-LINE/OFF-LINE switch to ON-LINE. Ensure that the 
READY light comes on. 
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B. For disk cartridge distribution: 

Mount the disk cartridge on a free unit. 

Move the LOAD/RUN switch (on the RK05) or the STOP/RUN switch (on 
the RK06 and RK07) on the drive to the RUN position; press the LOAD 
switch to the in position for RLOl's. 

Ensure that the READY indicator comes on. 

Ensure that the WR PROT indicator is lit. 

Type the following command, replacing dev with the device name and unit 
number of the disk: 

MOUNT dei.<:SYSLlG/RO 

MOUNT deu: SYSGNG/RO (for RK07 distribution only) 
Refer to Section 6.6. 

Step 30. BUILD and PATCH RSTS/E System Library 

Refer to Section 6.6. 

Step 31. Add Auxiliary Run-Time Systems and Patch Them 

Refer to Section 6.7. 

Step 32. Build and Patch Optional Software. 

Refer to Section 6.8. 

Step 33. Create System Message and Start-Up Control Files 

Refer to Section 6.9. 

Step 34. Create User Accounts 

Refer to Section 6.10. 

Step 35. Shut Down Target System 

Refer to Section 6.11. 

Step 36. Specify System Default Run-Time System. 

Refer to Section 6.11. 
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Sitep 37. Create Recovery Medium. 

Refer to Section 6.11 

Step 38. Start System for Time Sharing 

Refer to Section 6.12. 

Step 39. Verify System Start-Up Controi Fiies. 

Refer to Section 6.12. 

Step 40. Store Distribution and Recovery Media. 

Refer to Section 6.12. 
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Chapter 2 

Bootstrapping the Distribution IVledium 



The distribution medium is the tape or disk on which DIGITAL suppUes the 
RSTS/E system. To bootstrap the distribution medium, use the switches on 
the Central Processing Unit (CPU) to initiate a hardware loader that contains 
machine instructions for reading the first record of the distribution medium 
into memory. This record, called a bootstrap record, is a program that loads 
additional program code from the distribution medium into memory and 
executes that code. The code then prints a message on the console terminal 
marking the successful completion of the bootstrap procedure. For example: 

Enabling only c o n s o 1 e > d i s K s > and tapes. 

RSTS U7,0 (MTO) 

Option: 

For the bootstrap operation to succeed, the distribution medium must be on- 
line and ready; the medium accessed must contain a proper bootstrap record; 
the console terminal must be on-line. The following two sections describe the 
bootstrap procedures for each of the distribution media. Section 2.3 details 
hardware bootstrap procedures. 
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2.1 Bootstrapping Magnetic Tape Distribution 

The operation of the magnetic tape devices is described in the RSTS/E 
System User's Guide. To bootstrap the magnetic tape, proceed as follows: 

Physically mount the system generation tape on unit with the write 
enable ring removed. 

NOTE 

The 9 track, 800 bpi magnetic tape bootstrap in the system 
initialization code will not use a TU16, TE16, TU45, or TU77 
tape drive if a TUlO, TEIO, or TS03 drive is present. Therefore, 
if your system includes drives of both types (TU10/TE10/TS03 
and TU16/TE16/TU45ArU77), bootstrap the 800 bpi distribu- 
tion tape on the TUlO, TEIO, or TS03 drive. Similarly, the 1600 
bpi magnetic tape bootstrap will not use a TU16, TE16, TU45 
or TU77 tape drive if a tape is mounted and on-line on a TS04 
drive. 

Ensure that the tape is at its load point. (The BOT indicator light comes 
on.) The computer does not bootstrap the device unless the tape is at its 
load point. 

Set the ON-LINE/OFF-LINE switch on the tape unit to ON-LINE and 
ensure that the RDY indicator is lit. 

Ensure that the console terminal is on-line. 

Follow the bootstrap instructions in Section 2.3 for the type of hardware 
bootstrap device that is on the system. 



2.2 Bootstrapping Disk Distribution 

To bootstrap the disk cartridge, proceed as follows: 

Insert the disk cartridge in a free unit. 

Ensure that the RDY light is on. 

Ensure that the WR PROT light is on. 

Ensure that the console terminal is on-line. 

Follow the instructions in Section 2.3 for the type of hardware bootstrap 
device that is on the system. 

2.3 Hardware Bootstrap Procedures 

Bootstrapping a device involves using the Central Processor Unit (CPU) con- 
sole switches to access and initiate a hardware loader. The hardware loader 
contains machine instructions for reading a special record from the device. 

2-2 Bootstrapping the Distribution Medium 



The record, called a bootstrap record, is transferred into memory and executes 
a specially designed software program. For the bootstrap operation to succeed, 
the device accessed must be on-line and ready; the medium accessed must 
contain a proper bootstrap record; and the console terminal must be on-line. 

The PDP-11 console switches and their use are described in the Processor 
Handbook. The bootstrap procedure that you should use depends upon the 
type of hardware bootstrap device on the system. Table 2-1 summarizes the 
addresses needed to bootstrap each device. The detailed procedures to boot- 
strap a device are presented according to the types of hardware bootstrap 
devices available. 



Table 2-1: Summary of Hardware Bootstrap Addresses 






Dovice to Bootstrap 


Bootstrap Type 


BM873-YA 


BM873-YB* 


MRll-DB 


BM792-YB 


M9301-YA 


M9301-YB 


M9301-YC 


M9301-YF 


M93I2 


RFll Disk 


773000 


773136 


773100 


777462 












RSI03/RS04 Dislc 










DS 


DS 


100 


DS 


DS 


RPL05 disk cartridge 
Unit 


773010 


773030 


773110 


777406 


DK 


DK 


30 


DK 


DK 


RI>02 or RP03 disk 
pack unit 


773100 


773350 


773154 


776716 


DP 


DP 


40 


DP 


DP 


RP04, RP05, or RP06 
disik pack unit 




773320 








DB 


70 


DB 


DB 


RPM5 disk (unit n) 




773032 






DKn 


DKn 


30+n 


DKn 


DKn 


RL01/RL02 disk 
(unit n) 


















DLn 


RK06 disk (unit n) 
















DMn 


DMn 


RK07 disk (unit n) 


















DMn 


RI'02 or RP03 disk 
pack (unit n) 




773352 






DPn 


DPn 


40+n 


DPn 


DPn 


RI>04, RP05, RP06, 
RM02, RM03, or 
disk (unit n) 




773322 








DBn 


70+n 


DBn 


DBn 


TUIO/TEIO and 
TS03 magnetic tape 


773050 


773110 


773136 


** 


MT 


MT 


10 


MT 


MTn 


TU16/TE16/TU45/ 
TU77 magnetic tape 




773150 








MM 


60 


MM 


MMn 


TS04 magnetic tape 


















MSn 


* To bootstrap a nonzero disk unit, set the address in the Switch Register, press the LOAD ADRS switch, i 
the Switch Register, and press the START switch. 
** To bootstrap a TUIOATEIO or TS03 magnetic tape, use the loading routine described in Section 2.3.11. 


et the unit r 


lumber in 
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2.3.1 BM873-YA Procedure 

If the BM873-YA Restart/Loader is on the system, perform the following 
steps. 

Move the CPU Console ENABLE/HALT switch to its HALT position and 
back to its ENABLE position. 

Set the CPU Switch Register to one of the following values. 

773000 for RFll disk 

773010 for RK05 Disk Cartridge 

773100 for RP02 or RP03 disk pack 

773050 for TU10/TE10/TS03 magnetic tape 

Press the CPU LOAD ADRS switch. 

Press the CPU START switch. 

2.3.2 BM873-YB Procedure 

If the BM873-YB RestartA^oader is on the system, perform the following 
steps. 

Move the CPU Console ENABLE/HALT switch to its HALT position and 
back to its ENABLE position. 

Set the CPU Switch Register to one of the following values. 

773136 for RFll disk 

773030 for RK05 disk cartridge 

773350 for RP02 or RP03 disk pack 

773320 for RP04, RP05, RP06, RM02, or RM03 disk pack 

773032 for RK05 disk unit specified in the Switch Register 

773352 for RP02 or RP03 disk unit specified in the Switch Register 

773322 for RP04, RP05, RP06, RM02, or RM03 disk unit specified in 

Switch Register 
773110 for TU10/TE10/TS03 magnetic tape 
773150 for TU16/TE16/TU45ArU77 magnetic tape 

Press the CPU LOAD ADRS switch. 

If necessary, set the CPU Switch Register to the unit number of the disk 
drive being bootstrapped. 

Press the CPU START switch. 

2.3.3 H324 Pushbutton Panel Procedure 

If the system includes the H324 Pushbutton Panel option for the BM873 
Restart/Loader, perform the following steps. 

Move the CPU Console ENABLE/HALT switch to its HALT position and 
back to its ENABLE position. 
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While holding down the UNLOCK switch, press the appropriate switch to 
bootstrap the desired device. The DIGITAL field service engineer who 
installed the computer should have informed you of the device that each 
switch bootstraps. 

Press the CPU START switch. 



2.3.4 MR11-DB Procedure 

If the MRll-DB Bulk Storage Loader is on the system, perform the following 
steps. 

Move the CPU Console ENABLE/HALT switch to its HALT position and 
back to its ENABLE position. 

Set the CPU Switch Register to one of the following values. 

773100 for RFll disk 

773110 for RK05 disk cartridge 

773154 for RP03 disk pack 

773136 for TU10/TE10/TS03 magnetic tape 

Press the CPU LOAD ADRS switch. 

Press the CPU START switch. 



2.3.5 BM792-YB Procedure 

If the BM792-YB Hardware Loader is on the system, perform the following 
steps. 

Move the CPU Console ENABLE/HALT switch to its HALT position and 
back to its ENABLE position. 

Set the CPU Switch Register to 773100. 

Press the CPU LOAD ADRS switch. 

Set the CPU Switch Register to one of the following values. 

777462 for RFll disk 

777406 for RK05 disk cartridge 

776716 for RP03 disk pack 

Press the CPU START switch. 

2.3.6 M9301-YA and M9301-YB Procedures 

If the M9301-YA or M9301-YB Bootstrap Terminator is on the system, per- 
form the following steps. 

While holding down the CTRL switch, press the BOOT switch on the front 
of the computer. 
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The bootstrap prints the contents (in octal) of registers RO, R4, and the 
Stack Pointer, and the Program Counter at the console terminal. It then 
prints a prompting $ character. 

In response to the $ character, type the 2-character device code and the 
unit number of the device to be bootstrapped. Terminate your response by 
pressing RETURN. Table 2-2 describes the device codes. 

Table 2-2: Device Codes for M9301-YA and M9301-YB Bootstraps 



Device 


Code 


TU10/TE10/TS03 magnetic tape 


MT 


*TU16/TE16/TU45/TU77 magnetic tape 


MM 


RK05 Disk Cartridge 


DK 


RP02/RP03 Disk Pack 


DP 


*RP04/RP05/RP06/RM02/RM03 Disk Pack 


DB 


*RS03/RS04 Fixed Head Disk 


DS 


*M9301-YB Bootstrap Terminator only. 





2.3.7 M9301-YC Procedure 

If the M9301-YC bootstrap is on the system, perform the following steps. 

Move the CPU ENABLE/HALT switch to its HALT position and back to 
its ENABLE position. 

Set the start address of 17765000 in the console switches. 

Press the CPU LOAD ADDR switch. 

Set the device unit number in switches through 2. 

Set the device code for the device to be bootstrapped in switches 3 through 
6. Table 2-3 lists the device codes. 

Table 2-3: Device Codes for M9301-YC Bootstrap 



Device 


Code 


TU10ArElO/TS03 Magnetic Tape 


1 


RK05 Disk Cartridge 


3 


RP02/RP03 Disk Pack 


4 


TU16/TE16/TU45/TU77 Magnetic Tape 


6 


RP04/RP05/RP06/RM02/RM03 Disk Pack 


7 


RS03/RS04 Fixed Head Disk 


10 
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Ensure that switches 7 through 21 are off (down). 

Press the CPU START switch. 

NOTE 

Before the M9301-YC boostrap actually bootstraps the system, 
it performs CPU tests, instruction and addressing tests, and 
memory and cache tests. If a hardware failure is detected, the 
diagnostic program halts. The lights contain the ROM address 
of the halt. If this occurs, call the DIGITAL field service 
engineer. 

It may, however, be possible to continue with the bootstrap 
operation if the lights contain the address 1773764, which indi- 
cates a cache failure. To continue in this case, press CONT. 
This is the ONLY case in which it is possible to continue 
bootstrapping after the diagnostic program detects an error. 



2.3.8 M9301-YF Procedure 

If the M9301-YF Bootstrap Terminator is on the system, perform the follow- 
ing steps. 

While holding down the CTRL switch, press the BOOT switch on the front 
of the computer. 

The bootstrap prints the contents (in octal) of registers RO, R4, the Stack 
Pointer, and R5 at the console terminal. It then prints a prompting $ 
character. 

In response to the $ character, type the 2-character device code and the unit 
number of the device to be bootstrapped. Terminate your response by pressing 
RETURN. Table 2-4 lists the device codes. 



Table 2-4: Device Codes for M9301-YF Bootstrap 



Device 


Code 


TU10/TE10/TS03 Magnetic Tape 


MT 


TU16/TE16/TU45/TU77 Magnetic Tape 


MM 


RK05 Disk Cartridge 


DK 


RK06/RK07 Disk Cartridge 


DM 


RP02/RP03 Disk Pack 


DP 


RP04/RP05/RP06/RM02/RM03 Disk Pack 


DB 


RS03/RS04 Fixed Head Disk 


DS 
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2.3.9 M9312 Procedure 

The M9312 Bootstrap Module has five sockets that accommodate one CPU 
ROM and up to four peripheral boot ROMs. Each CPU and boot device has a 
unique ROM developed for it. The CPU ROM plugs into a specific socket 
location within the module. The peripheral ROMs, however, may be placed in 
any of the four peripheral socket locations as long as the sockets are filled in 
sequential order with no vacancies between loaded ROM sockets. Since a 
particular peripheral ROM has a different boot start address in each of the 
four sockets, it is sometimes important to know the locations of the ROMs in 
the bootstrap module. The ROM configuration is a diagram of where specific 
boot ROMs are located. This information must be known before the bootstrap 
procedure can begin. The following sections explain how to determine the 
ROM configuration if it is not known and how to bootstrap a device when the 
ROM configuration is known. Figure 2-1 is a diagram of the ROM arrange- 
ment for the M9312 Bootstrap Module. 

Figure 2-1: M9312 ROM Arrangement 



CPU 
ROM 



BOOT #1 ROM 



BOOT #2 ROM 



BOOT #3 ROM 



BOOT #4 ROM 



If the M9312 Bootstrap/Terminator is on the system, perform one of the 
following procedures: 

• If you have the M9312 console emulator on your system, follow the 
procedures in Section 2.3.9.1 (PDP-ll/60's and PDP-ll/70's usually do not 
have console emulators). If that procedure does not work, perform the next 
step to verify that you have a console emulator. 

• If you have a CPU equipped with switch registers and do not know what 
devices the M9312 will boot, perform the procedures in Section 2.3.9.2. 

• If you have a CPU equipped with switch registers, know what device ROMs 
are on the M9312 Bootstrap Module, but do not have a console emulator, 
follow the procedures in Section 2.3.9.3. 

• If you do not have the M9312 Botstrap/Terminator Module on your system 
and need to boot the RLOl, RL02, or the RK07 disk device, perform the 
manual load routine described in Section 2.3.10. 

2.3.9.1 Using the M931 2 Console Emulator — The M9312 console emulator can 
be initiated in two ways depending on the type of CPU (pushbutton or switch 
register) on the system. 
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1. Pushbutton boot using the M9312 console emulator. 

While holding down the CTRL button, press the BOOT button on the 
CPU. 

The bootstrap prints the contents (in octal) of registers RO, R4, the Stack 
Pointer, and R5 at the console terminal. It then prints a prompting @ 
character. 

In response to the @ character, type the 2-character device code and the 
unit number of the device to be bootstrapped. Terminate your response by 
pressing RETURN. If the unit number is not entered, it is assumed to be 
zero. Table 2-7 contains the device codes. 

Successful completion of these pushbutton bootstrap procedures produce 
header information on the console terminal, similar to the following 
example: 

Enabling o n 1 v console* d i s K s » and tapes 

RSTS i,'7.0 (MTO) 

Option: 

Begin the system generation process in Chapter 3 — Tailoring the SYSGEN 
System. 

2. Switch register boot using the M9312 console emulator. 

• Move the CPU console Enable/Halt switch to its Halt position then 
back to its Enable position. 

• Set the CPU switch register to 765020. 

• Press the start switch. The bootstrap prints the contents (in octal) of 
registers RO, R4, the Stack Pointer, and R5 at the console terminal. It 
then prints a prompting @ character. 

In response to the @ character type the 2-character device code and the 
unit number of the device to be bootstrapped. Terminate your response 
by pressing RETURN.* If the unit number is not entered, it is assumed 
to be zero. Table 2-7 contains the device codes. 

Successful completion of the switch register bootstrap procedure 
produces header information on the console terminal, similar to the 
example given for the pushbutton bootstrap. After the message appears, 
begin the system generation process in Chapter 3 — Tailoring the 
SYSGEN System. 

2.3.9.2 Determining the M9312 Bootstrap ROI\/l Configuration — If you do not 

know the M9312 ROM configuration, it can be determined by using Tables 
2-5 and 2-7 and performing the instructions that follow Table 2-5. 



*The @ sign returns at this point if the correct boot ROM was not installed, or if a nonexistent 
device code is entered. If the contents of the registers RO, R4, the Stack Pointer, and R5 appear 
before the @ sign, this indicates that at least one boot ROM socket is empty and can accom- 
modate another boot ROM. 
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Table 2-5: ROM Locations 



ROM Address 


ROM Location 


765774 


Diagnostic ROM 


773000 


ROM 1 


773200 


ROM 2 


773400 


ROM 3 


773600 


ROM 4 



Repeat the following steps for each of the ROM addresses shown in Table 2-5. 
After you have completed this process, you will know the M9312 bootstrap 
ROM configuration of your system. With this information, you can boot any 
device having a boot ROM in the M9312 Bootstrap Module. 

Table 2-6: M9312 Bootstrap ROM Configuration 



ROM 
Location 


Bootable 
Device 


Device 
Mnemonic 


Diagnostic 
ROM 

ROM 1 

ROM 2 

ROM 3 

ROM 4 







• Select a six digit ROM address from Table 2-5. 

• Set the CPU switches to the selected number. 

• Press the LOAD ADRS switch to set the ROM address. 

• Press the EXAM switch. The contents of the ROM address just loaded will 
appear in the CPU data register. 

• Match the octal number represented in the CPU data register with the octal 
data number shown in Table 2-7. 

• Locate in Table 2-7 the device mnemonic and the device name associated 
with the matching number. The ROM you have just investigated can boot 
the device (s) you located in Table 2-7. Write the retrieved device informa- 
tion from Table 2-7 with the appropriate ROM location in Table 2-6. For 
example, if you selected a six digit ROM address for ROM 1 from Table 2-5, 
place the device mnemonic and name you located in Table 2-7 with ROM 1 
in Table 2-6. Documenting the ROM configuration in Table 2-6 will pre- 
vent performing the above procedure again. 
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Table 2-7: Device Name and Mnemonic 



Device to 






Octal 


Be Booted 


Mnemonic 


Unit 


Data 


RLOl 


DL 


0-3 


042114 


RK06/RK07 


DM 


0-7 


042115 


RXOl 


DX 


0-1 


042130 


RX02 


DY 


0-1 


042131 


RS03/RS04 


DS 


0-7 


042123 


RP02/RP03 


DP 


0-7 


042120 


RP04/RP05/RP06 


DB 


0-7 




RM02/RM03 


DB* 






RK03/RK05 


DK 


0-7 


042113 


TU55/TU56 


DT 


0-7 




TU16/TE16/TU45/TU77 


MM 


0-7 


046515 


TU10/TE10/TS03 


MT 


0-7 


046524 


TS04 


MS 


0-7 


046523 


Console Emul. 


AO 


N/A 


040460 


CPU ROM 








Diagnostic ROM 


BO 


N/A 


041060 


PDP-11/60/70 






177776** 

XXX777*** 


* Type DB rather than DR if you are booting the RM02 or 


RM03 disk. 


** This is a continuation ROM of a multiple ROM boot. 




*** Bad ROM or NO ROM present. 





After you have determined the ROM configuration, perform the procedures in 
Section 2,3.9.1 if you find you have a console emulator; otherwise, perform the 
procedures in Section 2.3.9.3. The following section explains how to bootstrap 
with the M9312 module using a switch register controlled CPU. 

2.3.9.3 Bootstrapping with the M9312 — The following procedure describes 
how a device is bootstrapped when the M9312 Bootstrap ROM configuration 
is known. The data you need to bootstrap a device appears in Table 2-8. 

• Locate in Table 2-8 the name of the device to be booted. 

• Determine from the ROM configuration (Table 2-6) the location (ROM 
1/2/3/4) of the device boot ROM. 

• Select the three digit Switch Register Code (SWR) from Table 2-8 for the 
particular ROM location. 

• Move the CPU console Enable/Halt switch to its Halt position then back to 
its Enable position. 
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• Set the CPU switch register to 765744 (or 17765744 for PDP-11/70). 

• Press the CPU LOAD ADRS switch. 

• Set the Switch Register Code (SWR) selected from Table 2-8 in CPU 
switches 0-8 as shown in Table 2-9. 

• Set the unit number of the boot device in CPU switches 9-11 (see Table 
2-9). 

• Press the CPU start switch. 

Successful completion of this process boots the device. A message, similar to 
the following example, appears on the console terminal. At this point, you 
may begin the system generation process in Chapter 3 — Tailoring the 
SYSGEN System. 

Enabling only console* disKs* and tapes. 

RSTS M7.0 (MTO) 

Option: 

Table 2-8: Switch Register Codes (SWR) 







Switch Register Code (SWR) 












Be Booted 


ROM 1 


ROM 2 ROM 3 


ROM 4 


RL01/RL02 


012 


212 412 


612 


RK06/RK07 


012 


212 412 


612 


RXOl 


012 


212 412 


612 


RX02 


012 


212 412 


612 


RS03/RS04 


012 


212 412 


612 


RP02/RP03 


012 


212 412 


612 


RP04/RP05/RP06 


056 


256 456 


656 


RM02/RM03 


056 


256 456 


656 


RK03/RK05 


012 


212 412 


612 


TU56 


042 


242 442 


642 


TU16/TE16/TU45/TU77 


012 


212 412 


612 


TU10/TElOArS03 


012 


212 412 


612 



Table 2-9: Console Sv^^itch Register Settings 



15 


14 


13 


12 


11 


10 


09 


08 


07 


06 


05 


04 


03 


02 


01 


00 










































Oc 


talU 


nit 




Sw 


itch ] 


Regis 


ter C 


ode {i 


5WR 




1 



L_ Number _j _ from Table_2-8__ J 



2.3.10 Load Program Bootstrap for the RL01/RL02 and RK07 

To bootstrap an RLOl, RL02, or RK07 device when the system does not have 
the M9312 Bootstrap Module, you must manually enter a bootstrap load 
routine using the CPU console. The following procedure describes the manual 
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load process using the PDP-11/34. A similar procedure is followed using the 
CPU LOAD ADRS, DEP, and EXAM switches for the PDP-11/70 computer. 

« While holding down the CTRL button, press the HLT/SS button on the 
CPU. 

«» Set address 1000 in the console register by using the numbered console 
buttons. 

• Press the LAD (load address) button. 

• Press the CLR button to clear the register. 

• Load the contents, that appear below, into memory using the numbered 
buttons and the DEP button. Press the CLR button after you have placed 
the contents in the CPU register and pressed the DEP button. 





RL01/RL02 Bootstrap 


RK07 Bootstrap 




Routine 


Routine 


Address Contents 


Contents 


1000: 


12700 


12700 


1002: 


174400 


177440 


1004: 


12760 


12760 


1006: 


13 


0* 


1010: 


4 


10 


1012: 


12701 


12701 


1014: 


4** 


2003*** 


1016: 


10110 


10110 


1020: 


105710 


105710 


1022 


100376 


100376 


1024 


12760 


12760 


1026 


177601 


177400 


1030 


4 


2 


1032 


5721 


62701 


1034 


10110 


16 


1036 


105710 


10110 


1040 


100376 


105710 


1042 


12760 


100376 


1044 


177400 


5710 


1046 


6 


100001 


1050 


5060 





1052 


4 


5007 


1054 


62701 




1056 


: 6 




1060 


: 10110 




1062 


: 105710 




1064 


: 100376 




1066 


: 5710 




1070 


: 100001 




1072 


: 




1074 


: 5007 





♦Select drive number 0-7 for the RK07 

**Load 4 for unit 0, 404 for unit 1, 1004 for unit 2, and 1404 for unit 3. 
***Load 3 for RK06. 
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After the contents are loaded, perform the following steps. 

• Place address 1000 in the console register again by using the numbered 
buttons. 

• Press the CPU LAD (load address) button to load the address. 



• 



While holding the CTRL button down, press the START button on the CPU 
to boot the device. 



You can verify the accuracy of the load routine by using the CPU EXAM 
button. Place address 1000 in the register and press the LAD button. Press the 
EXAM button to reveal the contents of address 1000. It should be 12700 for 
both the RL01/RL02 and RK07 routines. Continue to press the EXAM button 
to check the contents of the remaining addresses in the load routine. Use the 
LAD and the DEP buttons to correct any erroneous contents. 



2.3.11 Load Program Bootstrap for the TU10, TE10, or TS03 

To bootstrap a TU10/TE10/TS03 magnetic tape when the system does not 
have a bootstrap that handles it, you must manually enter a load routine into 
memory using the CPU Console Switch Register and the DEP switch. 

To load the routine, perform the following steps. 

Move the CPU Console ENABLE/HALT Switch to its HALT position and 
back to its ENABLE position. 

Set the CPU Switch Register to 010000. 

Press the CPU LOAD ADRS switch. 

Load the following contents into memory using the Switch Register and 
DEP switch. 



Address 


Contents 


010000 


012700 


010002 


172524 


010004 


005310 


010006 


012740 


010010 


060011 


010012 


105710 


010014 


100376 


010016 


005710 


010020 


100767 


010022 


012710 


010024 


060003 


010026 


105710 


010030 


100376 


010032 


005710 


010034 


100777 


010036 


005007 
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Set the Console Switch Register to 010000. 

Press the CPU LOAD ADRS switch. 

Press the CPU START switch. 

If the system reads the tape but halts at address 010034, the magnetic tape 
generated a parity error. Try another drive and make it unit 0. If the system 
appears to take no action and halts, verify the accuracy of the routine by using 
the CPU Console EXAM switch. Use the Switch Register and the DEP switch 
to correct any erroneous contents. Rewind the tape to its load point before 
executing the routine again. If no recovery is successful, you should have a 
DIGITAL field service representative check the device. If the hardware is 
working properly, you should use a new magnetic tape reel. 
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Chapter 3 

Tailoring the SYSGEN System 



After you bootstrap the distribution medium, your next step in system genera- 
tion is to tailor the SYSGEN system for your installation. The initialization 
code includes options that you can use to tailor the SYSGEN system. The 
following sections describe the initialization options. 

3.1 Overview of Initialization Options 

When you bootstrap the RSTS/E distribution disk or tape, the RSTS/E sys- 
tem initialization code is loaded into memory. The RSTS/E system initializa- 
tion code (INIT.SYS) creates the RSTS/E file structure, system files, and 
start-up conditions for RSTS/E time sharing. The initialization code allows 
you to start the special SYSGEN monitor, which you can then use to generate 
a Target RSTS/E system. When the Target system generation process is com- 
plete, you can shut down the SYSGEN system and use the initialization code 
again to install the Target system monitor and start time sharing. 

The initialization code is one large stand-alone program with many functions. 
Initialization code routines (options) create a RSTS/E disk environment, in- 
stall the monitor and run-time system, and set system defaults. Initialization 
routines also check the integrity of the system disk and load stand-alone 
programs. They allow you to patch system components, declare device char- 
acteristics, and disable hardware units and controllers. 

Table 3-1 lists and describes briefly all the initialization options. The remain- 
ing portion of this chapter explains in detail the use of each option. Usually, 
you need not use all the options listed in Table 3-1 in tailoring the SYSGEN 
system. 
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Table 3-1: Initialization Options 



Option Name 



Abbreviation and Meaning 



DSKINT 



COPY 



PATCH 



HARDWR 



INSTALL 



REFRESH 



DEFAULT 



SET 



START 



BOOT 



LOAD 



DS 

Initializes, optionally formats, and performs pattern checks on any disk. 
Writes minimum RSTS/E file structure and can create the library ac- 
count [1,2], 

CO 

Transfers required system files from the distribution medium to an ini- 
tialized RSTS/E system disk. 

PA 

Alters RSTS/E system code to correct program errors and to add new 
program features. Can patch any file in account [0,1], including the ini- 
tialization code (INIT.SYS), and any Save Image Library (SIL). Uses 
patches, published in the RSTS/E Release Notes or in monthly issues of 
the RSTS/E Software Dispatch, to make code changes. 

HA 

Specifies device controller characteristics. Enables and disables device 
controllers, specifies non-standard addresses and vectors for device con- 
trollers, and specifies DMll-BB and DHll associations. 

IN 

Installs a RSTS/E Monitor. Designates the Save Image Library file to be 

used as the monitor for the SYSGEN or Target system. 

RE 

Creates and positions system swapping files, adds bad blocks to the bad 
block file, BADB.SYS, and positions optional system files on the system 
disk or any auxiliary disk. 

DE 

Establishes or changes a monitor's start-up defaults such as the job and 
swap maximum, the default run-time system, and the error message 
files. 

SE 

Sets device characteristics on a unit-by-unit basis. Enables and disables 
use of device units, sets and resets modem control for keyboards, estab- 
lishes and removes restrictions on the use of device units, and sets line 
printer characteristics. 

ST 

Starts the RSTS/E system for SYSGEN or normal time sharing. Loads 
monitor tables, enables devices, and loads the default run-time system 
into memory. Can override previously set system defaults for one time- 
sharing session. Can also be initiated by pressing LINE FEED in re- 
sponse to the OPTION: prompt. 

BO 

Bootstraps a tape or disk device. Can load another operating system into 
memory from disk or tape. Can reload an altered copy of the initializa- 
tion code after you have patched it on disk. 

LO 

Loads into memory and executes any stand-alone program located in 
account [0,1]. 



(continued on next page) 
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Table 3-1: Initialization Options (Cont.) 



Option Name 



UNISYS 



FILL 



SAVRES 



HELP 



Abbreviation and Meaning 



UN 

Starts the RSTS/E system without enabhng any terminal interfaces ex- 
cept the console terminal (KBO:). Can be used as a diagnostic tool when 
the system will not start, 

FI 

Tells the terminal driver in the initialization code to insert the proper 
number of fill characteristics when printing on the console terminal. 

SA 

Backs up (SAVE), reconstructs (RESTORlfe), copies (IMAGE) data disk 
to disk, and extracts (IDENTIFY) label information from a RSTS/E file- 
structured disk. 

HE 

Prints a list of valid options. 



3.2 Overview of the Tailoring Process 

The user interface with the initiaHzation code is a dialogue. Most questions in 
the dialogue have a long form and a short form. The initialization code auto- 
matically prints the short question. To receive the long form question, press 
the RETURN key in response to the short form question. Long form questions 
usually include information that may help you to answer the dialogue ques- 
tions. For example, pressing RETURN in response to the DSKINT option's 
PACK CLUSTER SIZE question yields a list of valid pack cluster sizes for 
the disk you are initializing. 

The initialization code dialogue begins with the OPTION: prompt and re- 
turns to this prompt after the execution of each option. Typing HELP in 
response to OPTION: gives you a list of valid responses, as in the following 
example. 



Option: HELP 

The i.)alid RSTB initialization options are 



Onl 



DSKINT 
COPY 
PATCH 
HARDWR 
INSTALL 
REFRESH 
DEFAULT 
SET 
START 
<LF> 
BOOT 
LOAD 
UNISYS 
FILL 
SAURES 
HELP 
the first 



Initialize d i s K to RSTS file structure 
Copy m i n i w a 1 system to d i s K 
Patch a file 

Set controller characteristics 
Install a monitor S I L 
Manipulate files in C > 1 ] 
Set monitor defaults 
Set deuice characteristics 
Start timesharing 
Start timesharing (fast) 
Bootstrap a deuice 
Load a stand-alone program 
Disable all but console terminal 
Set console fill for INIT 
SAUE or RESTORE a RSTS/E disK 
Type this HELP message 
two characters need be typed. 
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Option: 

To request an option, type the first two or more characters of its name. The 
initialization code executes the requested option. You can type CTRL/C m 
response to any question during the execution of the option to abort execution 
and return to the OPTION: prompt. 

Using the initiaHzation options, perform the following steps to tailor the 
RSTS/E SYSGEN system: 

1. DSKINT option - If you plan to put the SYSGEN and Target systems on 
separate disks, first mount and initialize the Target disk. Dismount it if 
you need the disk drive for the SYSGEN disk, then initiaUze the 
SYSGEN disk and leave it mounted. 

2. COPY option - Copy system files from the distribution medium to the 
SYSGEN system disk. After COPY completes the system file transfer, it 
automatically bootstraps the SYSGEN system disk. 

3. FILL option - If necessary, set the console fill factor. You may need to use 
this option if your console terminal is not an ASR33, KSR33, VT05, VT50, 
VT52, VTIOO, LA36, LA34, LA38, or LA120. The FILL option sets the 
console terminal fill factor used by the initialization code for the current 
system code. Fill characters are NULL characters used by each terminal 
for synchronization delays for outputting certain control characters (for 
example, form feed). The number of fill characters vary depending upon 
the terminal used. 

4. PATCH option - If necessary, correct errors in the initialization code, the 
SYSGEN monitor, and the RTll Run-Time System. 

5. HARDWR option - If necessary, disable device controllers and specify 
non-standard UNIBUS addresses for device controllers. 

6. INSTALL option - Install the file SYSGEN.SIL as the RSTS/E Monitor 
for system generation. 

7. REFRESH option - Allocate swapping and other system files for the 
SYSGEN system. 

8. DEFAULT option - Establish SYSGEN monitor defaults for job and swap 
maxima, the run-time system, the error message file, the installation 
name, the allocation of memory space, the crash dump facility, and the 
labelling format for magnetic tapes. 

9. SET option - If necessary, disable device units, and set type, width, and 
case for line printer units. 

10. START option - Start time sharing on the SYSGEN system. 

After starting the SYSGEN system, proceed to Chapter 4 to configure the 
Target system. The following sections describe in detail how to use the options 
mentioned above. 
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3.3 Initializing Disks 



Before using any disk under RSTS/E, you must initialize it. Initialization 
consists of formatting the disk (if it is not already formatted), performing 
pattern checks on the disk for bad blocks, and writing a RSTS/E file structure 
on the disk. Initialization is necessary for all disks. The exceptions are disks, 
such as swapping and non-RSTS/E disks, that should never be used 
file-structured. 

NOTE 

Initialization destroys the data on a disk. Therefore, do not 
initialize the distribution disk or any disk that contains import- 
ant information such as a monitor SIL. 

Formatting means writing the necessary timing and sense marks onto the disk 
and erasing any extraneous information. You must format the RK05, RK05F, 
RP02, RP03, RP04, RP05, and RP06 disks before using them on a RSTS/E 
system. Other removable disks, such as the RK06, RK07, RM02, and RM03, 
can be but do not need to be formatted since this procedure is performed at 
the factory; however, the RLOl and RL02 disks are formatted at the factory 
but cannot be formatted by D SKINT. 

You can choose from one to eight patterns, that DIGITAL supplies, to check 
for bad blocks on a disk. DIGITAL recommends that you use all eight patterns. 
Specifying a large number of patterns increases the probability that all bad 
blocks will be found and decreases the possibility that you will lose informa- 
tion later by writing into a bad block. You can also specify up to eight pat- 
terns of your own. If you want to specify your own patterns, create patterns 
different than those supplied by DIGITAL. The octal and binary word values, 
provided by DIGITAL and used during DSKINT pattern checking are: 

Binary 

000 000 000 000 000 

1 oil oil on on on 
1 111 111 111 111 111 
1 no on 001 oio no 

101 010 101 010 101 
000 111 100 001 111 

010 001 000 100 010 

1 000 100 010 001 000 

If you do not want to run eight patterns, you should at least run two. Running 
only one pattern merely writes zeroes to the disk. Whereas, specifying two 
instructs DSKINT to write one pattern to check the disk and the other 
pattern clears all blocks to zero. 

The minimal RSTS/E file structure contains a bootstrap block and two direc- 
tories. The Master File Directory (MFD) account [1,1] contains entries for 
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Pattern 


Octal 


1 


000000 


2 


133333 


3 


177777 


4 


163126 


5 


052525 


6 


007417 


7 


021042 


8 


104210 



itself and the system file account [0,1], the disk pack identification (pack ID), 
and the pack cluster size. In addition, it indicates whether the files on the disk 
are catalogued with information as to the date they were last accessed or the 
date they were last changed, whether new files are to be added at the begin- 
ning or at the end of a directory by default, and designates the disk as public 
or private. The User File Directory (UFD) for account [0,1] contains entries for 
the files SATT.SYS (Storage Allocation Table) and BADB.SYS (the '%ad 
block file"). 

During disk initialization you can request the creation of the system library 
account [1,2] on the disk. If you are initializing a system disk, the disk initiah- 
zation routines create the account [1,2] automatically. 



3.3.1 Initializing a Disk for Optimal Performance 

The disk initialization process allows you to set up a disk for optimal perform- 
ance. When you specify pack, MFD, and library cluster sizes, and position the 
file SATT.SYS, you can set up the disk to reduce access time and head 
movement. 

The disk pack cluster size must be a power of 2. It cannot be less than the 
device cluster size for the disk, which may be 1, 2, 4 or 8, nor greater than 16. 
The pack cluster size is the minimum number of disk blocks that the system 
can allocate to a file on the disk pack. It is thus the minimum account and file 
cluster size as well. A large pack cluster size can cause disk space to be wasted 
but can speed up file creation and access. For example, if the pack cluster size 
for a disk is 8, even a file that physically requires only 1 block is allocated 1 
pack cluster or 8 disk blocks. 

The IVIFD cluster size, which cannot be less than the pack cluster size nor 
greater than 16, is the cluster size for account [1,1]. This value Hmits the 
number of user accounts possible on the system to approximately 108 times 
the IVIFD cluster size. The number of user accounts which may be stored in 
the MFD is also affected by the number and size of files put in account [1,1]. 
DIGITAL recommends that the MFD cluster size be 16. 

You must set the system library [1,2] cluster size to at least 4. A larger value 
may be necessary if you intend to store many files in account [1,2]. DIGITAL 
recommends that the library cluster size be 16. The maximum number of files 
allowed in this or any other account is approximately 72 times the UFD 
cluster size for the account. This estimate may not be accurate for accounts 
with large files or for systems that use RMS. Files with attributes, which are 
normally created only by RMS, consume additional directory space in the 
UFD. The maximum number of files with attributes that can be saved under 
an account is approximately 54 times the UFD cluster size for that account. 

You have two options regarding the positioning of the file SATT.SYS: 

1. Calculate a location for SATT.SYS, or 

2. let DSKINT find a place for it. 
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For moving-head disks, it is advantageous to locate S ATT. SYS near the cen- 
ter of the disk to reduce average seek times for the disk heads. If you allow 
DSKINT to find a place for SATT.SYS, it will try to position that file near 
the center of the disk. If you decide to position subsequent files at the same 
mid-point, the initialization code merely locates the files as close to the center 
as possible. That is, DSKINT places the files at the next available space 
beyond the mid-point. 

DSKINT asks the PRE-EXTEND DIRECTORIES question during the ini- 
tialization dialogue. If you accept its default, DSKINT will allocate seven 
directory clusters for each of the following accounts: [0,1], [1,1], and [1,2] (if 
created). Ordinarily, DSKINT allocates only one directory cluster for each 
directory you are creating and the monitor expands the directory when it is 
necessary. If you allow the monitor to expand the size of the directories on an 
as needed basis, it will allocate the next directory cluster in the next available 
position, possibly making the directory non-contiguous. If you use this option, 
DSKINT will attempt to allocate all 7 directory clusters adjacent to each 
other, which may improve directory search times. 

3.3.2 Performing the Initialization 

To initialize a disk, use the DSKINT initialization option. If you plan to put 
SYSGEN and Target systems on separate disks, first mount and initialize the 
Target disk. Dismount it if you need the disk drive for the SYSGEN disk. 
After initializing the Target disk (if necessary), initialize the SYSGEN disk. 
To reduce confusion, use different pack IDs for the SYSGEN disk, the Target 
disk, and the distribution disk if it is present. Leave the SYSGEN disk 
mounted. Note that you must initialize each half of an RK05F disk separate- 
ly. Therefore, to initialize an RK05F, you must use the DSKINT option twice. 
Table 3-2 summarizes the DSKINT dialogue. After you answer the questions 
in the dialogue, DSKINT begins the initialization process. 

NOTE 

During the DSKINT dialogue, you can type CTRL/Z in re- 
sponse to any prompt after DISK? to cause DSKINT to return 
to the previous prompt. 

The first user-specified process that DSKINT performs is formatting. 
DSKINT prints STARTING FORIMAT PASS when it begins formatting, and 
END FORIVIAT PASS when it completes formatting the disk. The time re- 
quired for formatting depends on the size and type of disk involved. 

When RP02 and RP03 disks are being initialized, the DSKINT dialogue in- 
cludes two requests immediately after the STARTING FORMAT PASS 
IMESSAGE: 

SET FORMAT ENABLE SNITCH » THEN TYPE <LF>: 

You must set the RPll controller FORTvlAT ENABLE/NORlViAL switch to 
ENABLE, then press LINE FEED. 

SET FORMAT SWITCH TO NORMAL t THEN TYPE <LF>5 
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You must set the RPll controller FORMAT ENABLE/NORMAL switch to 
NORMAL, then press LINE FEED. 

After it formats the disk, DSKINT runs the pattern checks and counts the 
bad clusters. If DSKINT finds 161 or more bad clusters, it prints the message 
EXCESSIVE BAD CLUSTERS and returns the OPTION: prompt. Use a 
different disk. If the pack contains fewer than 161 bad clusters, DSKINT 
builds the RSTS/E file structure. When the building of the file structure is 
complete, DSKINT returns to the OPTION: prompt. 

If any errors, that are detected during pattern checking, report a block and 
cluster number, DSKINT adds that cluster number (not the block number) to 
the bad block file (BADB.SYS). Recoverable errors are not added into 
BADB.SYS. Several DSKINT examples follow Table 3-2 which describes the 
DSKINT dialogue questions. 

Table 3-2: DSKINT Dialogue Questions 



Question and Description of Response 



DD-MMM-YY? 

Type the current date in alphabetic or numeric format. The numeric 
date format is YY.MM.DD. Press LINE FEED to accept the date 
printed in the prompt. 

HH:MM? 

Type the current time in 24-hour or AM/PM format. For example, 14:53 
or 2:53 PM. Press LINE FEED to accept the time printed in the 
prompt. 

DISK? 

Type two characters to indicate the type of disk being initialized. 
Acceptable entries are DF, DS, DK, DL, DM, DP, DR, or DB. 

UNIT? 

For all disks except DF. Type the physical unit number on which the 
disk, DECpack, or disk pack resides. Acceptable entries are through 3 
for DL disks and through 7 for other disks. For an RK05F, use 
DSKINT twice, once for each half of the disk (i.e., once for each of the 
two units). 

PLATTERS(ri)? 

For DF type disks only. The value n in the prompt is the number of 
platters that the initialization code found. Press LINE FEED to use n 
as the number of platters. Otherwise, type the number of platters con- 
nected to the RFll controller. Acceptable entries are 1 through 8 for DF 
disks. 

PACK ID? 

Type one to six alphanumeric characters to be used when logically 
mounting the disk. RSTS/E uses this pack ID as a system-wide logical 
name for the disk and internally as the password of system account 

[0,1]. 



(continued on next page) 
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Table 3-2: DSKINT Dialogue Questions (Cont.) 



Question and Description of Response 



PACK CLUSTER SIZE? 

Type the number of 256-word blocks that each cluster allocated on the 
disk will contain. Acceptable pack cluster sizes are 1, 2, 4, 8, or 16 for 
RS()3, RS04, RK05, RK05F, RLOl, RL02, RK06, and RK07 disks. For 
RP02 and RP03 disks, acceptable values are 2, 4, 8, or 16. For RM02, 
RM03, RP04, and RP05 disks, acceptable values are 4, 8, or 16. For 
RP06 disks, acceptable values are 8 or 16. 

SATTiSYS BASE? 

Press LINE FEED to let DSKINT position the file near the center of 
the disk. It is generally advantageous to place the SATT.SYS file at the 
mid-point of removable disks. If you want to position the SATT.SYS 
file yourself, type the logical block number (from 1 to the device size 
minus 1) in decimal. DSKINT rounds this number up to the next pack 
cluster boundary. Refer to the text for an explanation. Appendix B 
contains a table of device sizes. You may want to locate SATT.SYS in a 
place other than the center if you only use the first half of the disk or 
need to create large contiguous files. 

MFD PASSNORD? 

Type one to six alphanumeric characters, which become the password of 
account [1,1] on the disk. 

MFD CLUSTER SIZE? 

Type the decimal number of 256-word blocks that each cluster allo- 
cated to the MFD will contain. The MFD cluster size must be a power 
of 2 greater than or equal to the pack cluster size and less than or equal 
to 16. The maximum number of user accounts that can be created is 
approximately 108 times the MFD cluster size. 

This setting is permanent; you can change it only by re-initializing the 
disk. 

DIGITAL recommends that the MFD cluster size be 16. 

PRE-EXTEND DIRECTORIES? 

Y, N. Type Y to have DSKINT extend accounts [0,1], [1,1], and [1,2] to 
their maximum size when they are created. 

PUB t PRl f OR SYS? 

Type PUB to designate the disk as public. Type PRI to designate the 
disk as private. Type SYS to initialize a system disk. 

CREATE LIBRARY ACCOUNT? 

For PUB or PRI disks only. Type Y to create the account [1,2] on the 
disk. If you type N, DSKINT does not create the account and does not 
ask the next three questions. 



(continued on next page) 
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Table 3-2: DSKINT Dialogue Questions (Cont.) 



Question and Description of Response 



LIBRARY PASSNORD? 

Type one to six alphanumeric characters to create the password for 
account [1,2]. 

LIBRARY UFD CLUSTER SIZE? 

Type the number of 256-word blocks allocated for each of the seven 
possible UFD clusters for the library account [1,2]. The number of files 
that can be stored under any account is approximately 72 times the 
UFD cluster size. The library UFD cluster size must be a power of 2. It 
cannot be less than the pack cluster size or greater than 16. DIGITAL 
recommends that the library UFD cluster size be 16. 

LIBRARY ACCOUNT BASE? 

A number (in blocks) from 1 to the disk size minus 1. Press LINE FEED 
to let DSKINT place the library near the center of the disk. 

DATE LAST MODIFIED? 

Type Y or press LINE FEED to retain in the disk directory the date on 
which files were last modified. Type N to retain the date on which files 
were last accessed. 

NEW FILES FIRST? 

Type N or press LINE FEED to cause new files on this disk to be placed 
at the end of the directory for the account in which they are created. 
DIGITAL recommends this response. 

Type Y to cause new files on this disk to be added at the beginning of 
the directory for the account in which they are created. 

USE PREUIOUS BAD BLOCK INFO? 

Type Y or press LINE FEED to have the new bad block file created 
using information from the existing bad block file. DIGITAL recom- 
mends this response. 

Type N to have DSKINT ignore the current bad block file when creat- 
ing the new one. 

FORMAT? 

Asked for DK, DIM, DP, DR, and DB disks only. Type Y to write 
hardware timing and sense data on the disk. Type N to omit the format- 
ting operation. If you type Y, DSKINT prints messages indicating the 
start and end of the format pass. You must format all new disk packs 
and cartridges (except RLOl and RL02 which are formatted at the fac- 
tory and cannot be reformatted; RK06, RK07, and RM02 which are 
formatted at the factory but can be reformatted) before using them on a 
RSTS/E system. You should never format a disk that contains any 
important data; formatting destroys the data on the disk. 



(continued on next page) 
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Table 3-2: DSKINT Dialogue Questions (Cont.) 



Question and Description of Response 



PATTERNS? 

To print the time required to execute each pattern for each type of disk, 
press RETURN. To specify the number of patterns to use in checking 
for bad blocks, type a number from one to eight. DIGITAL recommends 
that you run eight patterns. If you append an X to your response, 
DSKINT uses the specified number of DIGITAL'S patterns and asks the 
next question. 

YOUR PATTERN? 

Asked only if the response to the last question ended with the letter X. 
(This capability is intended primarily for DIGITAL field service engi- 
neers.) Type an octal word between 1 and 177777, inclusive. The 
DSKINT option repeats the question until you have typed 8 patterns or 
pressed LINE FEED to indicate no more patterns. 

PROCEED (Y or N)? 

Type Y to proceed with the disk initialization. Type N to abort the 
initialization and return to the OPTION: prompt. This question allows 
you to double-check your responses to the dialogue questions and abort 
the initialization if you have made any errors. 



3.3.3 Initializing a System Disk 

In this example, you initialize the disk to be used as the SYSGEN system 
disk. The printout from the dialogue follows. Each line is marked with a letter 
and is explained in the subsequent text. 

a Option: DSKINT 

b ia-May-79? 

c 02:^9 AM? 02:49 PM 

d DisK? DBO 

This disK pacK appears to be a RSTS/E formatted 
disK with the following characteristics: 

e PacK ID : SAMPLE 

Pack cluster size : 8 
PacK is currently : P r i i.j a t e » 

Update access date on writes. 

f PacK ID? SA|v|pLE2 

g PacK ID? SAMPL2 

h PacK cluster size? ^ 

i SATT.SYS base? 

j MFD password? |v|pdim|v|e; 

k MFD password? SECRET 

1 MFD cluster size? jg 

m P r e - e X t e n d directories < n o > ? y 

n PUB » PRI » or SYS? sYS 

o Library password? SECRET 

p Library UFD cluster size? jg 
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q Library account base? 

r D a t e 1 a 5 1 (ti d i f i e d < >' e 5 > ? 

s N e w f i 1 e s f i r 5 t < n > ? 

t Use p r e i.f i u 5 bad b 1 o c K info < v .- s > ? 

u Format < n o > ? Y 

V Patterns? 8 

w Proceed (Y or N)? Y 

Startinsfformatpass 

End f r (Ti a t pass 

X Pattern « 8 

DBO Error RPCSl RPWC RPDA RPCS2 RPDS RPERl RPDC 

4 2 B 00 5 4 1 S 1 1 7 0537 

R e c 1.) e r a b 1 e 

144250 177553 0100 4 3 1507 1 B 3 

144250 177553 010000 040300 150700 100000 000B03 

R e c M e r a b 1 e 

Pattern « 7 

DBO Error RPCSl RPWC RPDA RPCS2 RPDS RPERl RPDC 

144250 1 7 B 5 5 3 010 4 3 1507 1 B 4 

144250 1 7 B 5 5 3 0100 4 3 1507 1 B 4 

144250 177553 010000 040300 150700 100000 000B04 

144250 177553 010000 040300 150700 100000 000B04 
BlocK Cluster 

1B252B 40B30 

Pattern # B 

DBO Error RPCSl RPWC RPDA RPCS2 RPDS RPERl RPDC 

144250 177553 0100 4 3 1507 1 B 3 

144250 177553 010 0403 1507 1 B 3 

144250 177553 0100 4 3 1507 1 B 3 

144250 177553 010 4 3 1507 1 B 3 
BlocK Cluster 

1B2108 4052B 

144250 1 7 B 5 5 3 01000 4 3 1507 1 B 4 

144250 17S553 010000 040300 150700 100000 000 BO 4 

R e c M e r a b 1 e 

Pattern « 5 

DBO Error RPCSl RPWC RPDA RPCS2 RPDS RPERl RPDC 

144250 177553 010 4 3 1507 1 B 3 

144250 177553 010000 ,0 4 3 1507 1 B 3 

144250 177553 0100 4 3 1507 1 B 3 

144250 177553 0100 4 3 1507 1 1 B 3 
BlocK Cluster 

1B2108 4052B 

144250 1 7 B 5 5 3 010 4 3 1507 1 B 4 

144250 i7B553 010000 040300 150700 100000 000B04 

144250 177553 010000 040300 150700 100000 000B04 

1B252B 40B30 

Pattern « 4 

DBO Error RPCSl RPWC RPDA RPCS2 RPDS RPERl RPDC 

144250 177553 010000 040300 150700 100000 00 OB 03 

144250 177553 01000 4 3 1507 1 B 3 

144250 177553 0100 4 3 1507 1 B 3 

144250 177553 0100 4 3 1507 1 S 3 
BlocK Cluster 

1B2108 4052B 
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Pattern » 3 














DBO Error RPCSl 


RPWC 


RPDA 


RPCS2 


RPDS 


RPERl 


RPDC 


14^250 


177553 


010000 


040300 


150700 


100000 


000G03 


144250 


177553 


010000 


040300 


150700 


100000 


000G03 


144250 


177553 


010000 


040300 


150700 


10 0000 


000G03 


144250 


177553 


010000 


040300 


1507 00 


100000 


000G0 3 


B 1 c K Cluster 














1B2108 4052G 














144250 


17B553 


010000 


040300 


150700 


100000 


000S04 


144250 


177553 


010000 


040300 


150700 


100000 


000B04 


144250 


177553 


010000 


040300 


150700 


100000 


000G04 


1G252G 40B30 














Pattern w 2 














DBO Error RPCSl 


RPWC 


RPDA 


RPCS2 


RPDS 


RPERl 


RPDC 


144250 


17432B 


003005 


040300 


150700 


100100 


OOOGOl 


144250 


17432B 


003005 


040300 


150700 


100000 


000601 


R e M e r a b 1 e 














144250 


177553 


010000 


040300 


150700 


100000 


000G03 


144250 


177553 


010000 


040300 


150700 


100000 


000G03 


144250 


177553 


010000 


040300 


150700 


100000 


000G03 


B 1 K Cluster 














1B2108 4052G 














144250 


17B553 


010000 


040300 


150700 


100000 


000G04 


144250 


177553 


010000 


040300 


150700 


100000 


000 GO 4 


144250 


177553 


010000 


040300 


150700 


100000 


000604 


1B252S 40B30 














Pattern » 1 














Option: 















The letters that prefix the explanations that follow are keyed to identifying 
letters located within the previous DSKINT example. Follow the lettered 
steps through this sequence of steps. 

a. Specify the DSKINT option by typing DSKINT. Typing at least the first 
two letters of DSKINT will also invoke this option. 

b. Press LINE FEED to accept the date printed by DSKINT since the date is 
correct. If it had been incorrect, you would have typed the current date in 
the indicated format. 

c. Correct the time by entering the hours and minutes but also indicate that 
the time is in the afternoon by typing PM. 

d. Type DBO which represents the mnemonic name and the unit number of 
the RP06 that you want to DSKINT. If you had not included the unit 
number in your response, DSKINT would have printed the UNIT ques- 
tion. You respond to the UNIT question with the unit number of the device 
on which the SYS GEN disk is mounted. DSKINT prints this question for 
DS, DK, DL, DM, DP, DR, and DB disks. For an RSll (DF) disk, the 
PLATTERS question replaces the UNIT question. You would respond to 
this question by typing the number of RSll disks (platters) connected to 
the RFll controller. 
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e. Notice that DSKINT identifies that the disk is a RSTS/E formatted disk 
and proceeds to Hst a few of its characteristics. This gives you an opportu- 
nity to decide whether it is the disk that you want to DSKINT. This label 
data provides enough information to make that decision. 

f. Type more than six characters and DSKINT reprompts the DISK ques- 
tion. Type six or less and your response is accepted. 

g. Type one to six alphanumeric characters which become the pack identifi- 
cation label for the SYSGEN disk. RSTS/E uses this label as a system- 
wide logical name for the disk and internally as the password of system 
account [0,1]. 

h. Specify the pack cluster size for the system disk. Refer to Appendix B for a 
list of disk device cluster sizes. The pack cluster size must be at least the 
device cluster size and no greater than 16. In general, large pack cluster 
sizes permit faster access to data stored on the disk at the expense of 
wasted disk space. Small pack cluster sizes permit more efficient alloca- 
tion of disk storage space at the expense of frequent access to retrieval 
information (pointers to file data) stored in user file directories. You can 
improve the access speed on a disk with a small pack cluster size by 
grouping individual files and user file directories (UFDs) at a size greater 
than the pack cluster size. DIGITAL recommends the minimum pack 
cluster size for almost all installations. 

i. Have DSKINT place the Storage Allocation Table SATT.SYS file near the 
center of the disk since it will be accessed frequently. This procedure 
makes possible the reduction of average seek time for the disk heads. 
However, you may not want the file near the center of the disk if you only 
use information located in the first half of the disk or if you need to create 
large contiguous files. 

j. Type an MFD password greater than six characters and DSKINT rejects 
it. 

k. Type one to six alphanumeric characters which become the password for 
the Master File Directory (MFD) account [1,1]. The MFD password should 
be kept secret, because irresponsible access to any privileged account can 
destroy system security. To further prevent a security break, choose an 
MFD name that cannot be easily guessed. 

1. Specify the cluster size for the MFD. With the restriction that the MFD 
cluster size cannot be less than the pack cluster size, the MFD cluster size 
can be 1, 2, 4, 8, or 16. Note that the system manager can create approxi- 
mately (108 * MFD cluster size) accounts. Digital recommends that the 
cluster size be 16. 

m. Respond by typing Y to have DSKINT extend to the maximum size the 
directories for account [0,1], [1,1], and [1,2] when these files are created. 
The directories are then created at the 7 block maximum which may, since 
the directory is made contiguous, decrease directory search times. 
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n. Type SYS to initialize a system disk. For a system disk, DSKINT auto- 
matically creates the library account [1,2] and prints the next 
two questions. 

o. Type one to six alphanumeric characters which become the password for 
account [1,2]. Keep this password secret and create a name that is not 
easily guessed. If you have two systems, do not use the same password for 
both. 

p. Specify 16 as the cluster size for account [1,2]. The cluster size for the 
system library must be at least 4. You may need to specify a larger cluster 
size if you plan to save many of your installation's library files in account 
[1,2]. DIGITAL recommends that the library cluster size be 16. 

q. Press LINE FEED to have DSKINT place the library account [1,2] near 
the center of the disk. This location diminishes the average seek time for 
the disk heads. You can, however, specify a location in blocks if another 
location is more advantageous. That is, if you only use the first half of the 
disk or need to create large contiguous files, you may not want to locate the 
library account near the disk's center. 

r. Accept the YES default to retain in the disk directories the date on which 
files were last modified not the date on which files on the disk were last 
accessed. 

s. Press LINE FEED to cause new files on a disk to be placed at the end of 
the directory for the account in which they were created. DIGITAL recom- 
mends this response which allows the frequently used system programs (for 
example LOGIN and LOGOUT) to be located at the beginning of the 
directory where they can be quickly accessed. 

t. Press LINE FEED to have the new bad block file created using informa- 
tion from the existing RSTS/E bad block file, if one exists. DIGITAL 
recommends this response. 

u. Type Y to allow DSKINT to write hardware timing and sense data on the 
disk. 

v. Request that DSKINT perform 8 pattern checks for bad blocks. DIGITAL 
recommends this number. The time that you spend running these pattern 
checks may protect you from encountering bad blocks during an important 
run, a condition that may be avoided if you perform all 8 pattern checks. 

w. Type Y to proceed, since you made no errors during the DSKINT dialogue 
sequence. After you press RETURN, DSKINT begins the format pass, 
then notifies you when it starts and ends. 

x. Notice that DSKINT begins pattern checking with pattern 8 and ends 
with pattern 1. If DSKINT prints a block and cluster number during 
pattern checking, it adds the cluster number to the bad block file 
(BADB.SYS). In this example, DSKINT adds cluster numbers 40630 and 
40526 to BADB.SYS. Errors that DSKINT marks as RECOVERABLE, 
such as those in patterns 8, 6, 2, are not added to the bad block file. 

y. Notice that DSKINT returns you to the OPTION prompt. 
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3.3.4 Initializing a Nonsystem Disl( 



The DSKINT option initializes, formats, and does pattern checking on non- 
system disks that will be used on the RSTS/E system. System disk initializa- 
tion is described in Section 3.2.3. The example that follows applies only to 
nonsystem disks. 

The following example initializes an RK06 cartridge as a private disk: 



Option: DSKINT 

DD-MM-YY? ia-MAY-79 
12:01 AM? 

DisK? DMl: 

This disk pacK appears to be a RSTS/E formatted 
disK with the following characteristics: 

PacK ID : PATCHA 

Pack cluster size : 2 

Pack is currently : P r i ».< a t e . 

Pack ID? SAMPLE 

Pack cluster size? 4 

SATT.SYS base? 

MFD password? SYSMFD 

MFD cluster size? IB 

Pre -ex tend directories <no>? Y 

PUB t PRI » or SYS? PR I 

Library password? SYSLIB 

Library UFD cluster size? 16 

Date last modified < y e s > ? 

New files first <no>? 

Use previous bad block info < v e s > ? 

Format < n o > ? Y 

Patterns? 8 

Proceed (Y or N)? Y 

Disk pack serial « 754B5 

C y 1 T r k Sec Block Cluster 
2G0 1 11 17193 4298 
332 1 11 21945 5488 

Start in f( format pass 
End format pass 

Pattern ** 8 

DMl Error RKCSl RKWC RKDA RKCS2 RKDS RKER RKDCYL 
100222 171502 000413 000201 100301 000200 000404 
100222 177502 000413 000201 100301 000200 000404 



Block Cluster 
17193 4298 



100222 177502 000413 000201 100301 000200 000514 
100222 177502 000413 000201 100301 000200 000514 



21945 548B 
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Pattern # 7 

DM1 Error RKCSl RKWC RKDA RKCS2 RKDS RKER RKDCYL 
100222 171502 000413 000201 100301 000200 000404 
100222 177502 000413 000201 100301 000200 000404 
B 1 c K Cluster 
17193 4298 

100222 17 7502 000413 000201 100301 000200 000514 
100222 177502 000413 000201 100301 000200 000514 
21945 54SB 

Pattern « G 

DM1 Error RKCSl RKNC RKDA RKCS2 RKDS RKER RKDCYL 
100222 171502 000413 000201 100301 000200 000404 
100222 177502 000413 000201 100301 000200 000404 

BlocK Cluster 

17193 4298 

100222 177502 000413 000201 100301 000200 000514 
100222 177502 000413 000201 100301 000200 000514 

21945 548G 

P a 1 1 e r n tt 5 

DM1 Error RKCSl RKWC RKDA RKCS2 RKDS RKER RKDCYL 
100222 171502 000413 000201 100301 000200 000404 
100222 17 7502 000413 000201 100301 000200 000404 



Block Cluster 
17193 4298 



100222 177502 000413 000201 100301 000200 000514 
100222 177502 000413 000201 100301 000200 000514 
21945 548S 

Pattern # 4 

DM1 Error RKCSl RKWC RKDA RKCS2 RKDS RKER RKDCYL 
100222 171502 000413 000201 100301 000200 000404 
100222 177502 000413 000201' 100301 000200 000404 

BlocK Cluster 

17193 4298 

100222 177502 000413 000201 100301 000200 000514 
100222 177502 000413 000201 100301 000200 000514 

21945 54'8e 

P a 1 1 e r n # 3 

DM1 Error RKCSl RKWC RKDA RKCS2 RKDS RKER RKDCYL 
100222 171502 000413 000201 100301 000200 000404 
100222 177502 000413 000201 100301 000200 000404 

Block Cluster 

17193 4238 

100222 177502 000413 000201 100301 000200 000514 
100222 177502 000413 000201 100301 000200 000514 

21945 548G 

Pattern « 2 

DM1 Error RKCSl RKWC RKDA RKCS2 RKDS RKER RKDCYL 
100222 171502 000413 000201 100301 000200 000404 
100222 177502 000413 000201 100301 000200 000404 



Block Cluster 
17193 4298 



21945 548G 



100222 177502 000413 000201 100301 000200 000514 
100222 177502 000413 000201 100301 000200 000514 
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P a 1 1 e r n tt 1 

DM1 Error RKCSl RKWC RKDA RKCS2 RKDS RKER RKDCYL 

100222 171502 000ai3 000201 100301 000200 OOU^O<a 

100222 177502 000413 000201 100301 000200 000404 
B 1 c K Cluster 

17193 4238 - - - ^ h /. 

100222 177502 000413 000201 100301 0002UU U0U514 

100222 177502 000413 000201 100301 000200 000514 

21345 548G 

Option: 

In the example, the pattern checks discovered bad blocks. Since bad blocks 
were found, DSKINT prints a summary of the block number, cluster, and 
hardware information (for use by DIGITAL field service personnel). 

3.3.5 Initializing a Non-File Structured Disk 

It is not necessary to use DSKINT on non-file structured disks that you will 
use for swapping. However, you can use the DSKINT option to perform 
pattern checking on these disks. Such disks do not require the RSTS/E file 
structure that DSKINT creates. The file structure is useless and is overwrit- 
ten during time sharing operations. 

During an initial hardware installation or when a hardware malfunction is 
suspected, DSKINT can supplement the tests performed by standard diag- 
nostic methods. DSKINT does not duplicate all the tests performed by diag- 
nostic programs. DSKINT, therefore, should be used only to complement the 
standard hardware maintenance procedures. 

The example that follows shows the use of DSKINT to run pattern checks on 
an RS04 fixed head disk. 

Option: dSKINT 

14-MAY-79 
08:17 Ah? 

Disk? Ds 

Unit? 

PacK ID? SWAP 

PacK cluster sise? ^ 

BATT.BYS base? 

MFD password? gupMFD 

MFD cluster size? ^ 

P r e - e X t e n d d i r e c t o r i p ^i < n o > ? y 

PUB f PRI » or SYS? pye 

Create library account? |^ 

Date last modified < v e s > ? 

New files first <no>? 

Use p r e u i u s had b 1 o c K info < yes > ? ^ 

Patterns? g 

Proceed ( Y or N ) ? y 

Pattern # 8 
Pattern « 7 
Pattern # B 
Pattern « 5 
Pattern « 4 
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Pattern » 3 
Pattern » 2 

DSO Error RSCSl RSNC RSBA RSDA RSCB2 RSDS RSER 

laaZSO 1720GS 056154 001463 040700 OlOGOO 000000 
Recoverable 

Pattern ** 1 

Option: 

If DSKINT discovers bad blocks on a fixed head disk, you should not use the 
disk non-file structured for swapping. Call DIGITAL field service to locate the 
hardware problem. You can avoid the bad blocks by using the disk for 
file -structured swapping space. Refer to Section 3.8.1.1 for a discussion of 
swapping files. 



3.3.6 DSKINT Dialogue Error Messages 

Table 3-3 summarizes the error messages that can appear during the 
DSKINT option dialogue. 

Table 3-3: DSKINT Dialogue Error Messages 



Message and Meaning 



BLOCK NUMBER TOO BIG 

The block number you typed is greater than or equal to the maximum 
logical block number for the disk. 

DRIME NOT READY 

The initialization cannot proceed because the disk to be initialized is 
not on-line and ready. You can ready the drive and press LINE FEED 
to proceed or you can type CTRL/C to abort the initialization. 

DSKINT NOT LEGAL ON SYSTEM DISK 

You specified the disk from which the initialization code was 
bootstrapped. You cannot initialize this disk now because the initializa- 
tion code would be destroyed. 

ILLEGAL DISK NAME 

The string you typed is not the name of a valid RSTS/E disk device. 

ILLEGAL NUMBER f TRY AGAIN 

The number you typed is not a valid octal number between 1 and 

177777. 

SORRY, BUT THAT DISK DOESN'T EXIST 

The string you typed is a valid RSTS/E disk name, but that disk con- 
troller or the unit number does not exist on this sytem. 



The preceding table describes only some of the errors that can occur during 
the DSKINT option dialogue. For information on the error messages that can 
appear during the initialization process, refer to Appendix A. 
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3.4 Copying System Files to Disl( 

During tailoring of the SYSGEN system, the COPY option copies system files 
from account [0,1] on the distribution medium to the SYSGEN disk. During 
tailoring of the Target system, COPY transfers system files from account [0,1] 
on the SYSGEN output tape to the Target disk. The list that follows describes 
the system files that COPY transfers from the distribution medium: 

1. The INIT.SYS file contains the system initialization code. 

2. SYSGEN.SIL (for the SYSGEN system) or the first file in [0,1] with the 
extension .SIL (for the Target system), which is the RSTS/E IVIonitor 
Save Image Library. 

3. RTll.RTS (for the SYSGEN system) or the first file in [0,1] with the 
extension .RTS (for the Target system), which is the run-time system. 

4. ERR.ERR (for the SYSGEN system) or the first file in [0,1] with the 
extension .ERR (for the Target system), which is the RSTS/E error 
message text. 

5. All files in [0,1] with the extension .SAV, which are stand-alone programs 
that can be loaded by the LOAD option. DIGITAL does not supply any 
stand-alone programs. 

The COPY option automatically copies the files from the device that was last 
bootstrapped. If you are tailoring a SYSGEN system, the option copies the 
files from the distribution disk or magnetic tape. If you are tailoring a Target 
system, the option copies the files from the system tape or disk written by the 
batch stream. 

As it attempts to transfer each file, COPY scans the output disk for a file with 
the same name. If it finds one, COPY issues the following prompt, substitut- 
ing the filename and extension for filnam.ext. 

FILE filnam.ext EXISTS: 

Press RETURN for the following additional information: 

The file named a b o y e already exists on the output disk. 
Type 'D' to delete it and create a new file of the same name. 
Type ' S ' to s K i p this input file and continue. 
Type CTRL/C to abort the COPY operation: 

After each filename scan, COPY creates the file on the output disk and copies 
the contents of the input file to it. However, COPY neither creates nor copies 
the file if it finds the file on the output disk and you specify 'S '. The COPY 
option does not generate an error message if one or more of the input files is 
missing. 

After COPY has transferred all the files, it scans the output disk to verify that 
account [0,1] contains a minimal set of system files (INIT.SYS, a .SIL file, a 
.RTS file, and a .ERR file). If one or more of the files is missing, COPY prints 
an error message and returns to the OPTION: prompt. If all the files are 
present, it bootstraps the output disk and returns to the OPTION: prompt, 
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Therefore, the initialization code is running with a different system device 
after the COPY option terminates successfully. 

The following is an example of the COPY option: 

Option : COPY 

20-riAY-79? 
08:27 AM? 

To which d i sk? DB 
Unit? 

Enabling only console* d i s K s » and tapes. 

RSTS M7.0 (DBO) 

Option : 

In the example, you press LINE FEED to accept the date and time printed. 
The DB response to the TO WHICH DISK question and the response to the 
UNITS question specify the device to which COPY transfers the system files. 
The COPY option copies the files, then bootstraps the output disk. After 
COPY bootstraps the DB disk, the initialization code prints the system iden- 
tification message (indicating the booted device) and the Option: prompt. 

NOTE 

To copy to the output disk all files that have .SIL, .RTS, and 
.ERR extensions, you can use the /A switch in response to the 
TO WHICH DISK query. For example: 

TO WHICH DISK?DB/A 

Table 3-4 summarizes the error messages that can appear during the COPY 
option dialogue. 

Table 3-4: COPY Option Dialogue Error Messages 



Message and Meaning 



CANNOT COPY TO THE SYSTEM DISK 

You specified the current system disk, which is invalid as an output 
disk for the COPY option. 

ILLEGAL DISK NAME 

You typed an invalid disk name or specified a unit number for a DF 
disk. 

INMALID UNIT NUMBER 

The disk unit number you specified does not exist on this system. 

INMALID RESPONSE 

Your response to the FILE FILNAM.EXT EXISTS: prompt was not D, 
S, or CTRL/C. 

SORRY f BUT THAT DISK DOESN'T EXIST 

The disk type you specified does not exist on this system. 
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For information on errors that occur during the copying operation, refer to 
Appendix A. 



3.5 Correcting the System Code 



The PATCH option provides a method for altering RSTS/E system code. Use 
PATCH to correct errors that are found in the system code and to add op- 
tional program code. DIGITAL publishes mandatory corrections and optional 
additions to code in the RSTS/E Release Notes if the changes are concurrent 
with the release of the distribution kits. Between releases, patches are pub- 
lished in the monthly RSTS/E Software Dispatch publication. The following 
procedures describe the PATCH option in detail. In general, however, pub- 
lished patches include the necessary instructions. 

You can patch any file in account [0,1]. This account includes the initializa- 
tion code (INIT.SYS) and any .SIL or .RTS file. Patching makes permanent 
changes to the code on disk and has no effect on the code currently in memo- 
ry. Therefore, after patching the initialization code, you must bootstrap the 
system disk to load the corrected initialization code into memory. 

Patches take many different forms. Some are in-place patches to one or more 
words in one or more modules. Others require patch space in the affected 
areas. The RSTS/E Monitor, initialization code, and run-time systems always 
include patch space. You can patch the overlay code by using free space in 
overlay segments or monitor patch space. Sometimes, patches affect fixed 
addresses and are straightforward; usually, however, the exact octal address 
of a patch varies from system to system according to the system configuration. 
Published patches describe in detail the procedures required to make the 
alterations correctly. 

When you generate- a new RSTS/E system, refer to the RSTS/E Release Notes 
and the RSTS/E Software Dispatch for patches and patching information. 
Unless instructed otherwise by the RSTS/E Release Notes, you should install 
all required patches immediately after the SIL is placed on the SYS GEN or 
Target system disk. This procedure is necessary because patches may affect 
the initialization code, which builds required file structures, creates system 
files, and sets up tables used during time sharing. 

3.5.1 Using the PATCH OPTION 

Use the PATCH option to perform patching operations. To invoke PATCH, 
type PATCH or PA. PATCH replies by asking for the name of the file to 
patch, a MODULE NAME (if the file is a SIL and has more than one 
module), a BASE ADDRESS, and an OFFSET ADDRESS. 

In response to the FILE TO PATCH question, type the name and extension of 
the file that requires patching, or press LINE FEED to patch the installed 
monitor SIL. Since the initialization code cannot always distinguish a SIL 
from other files, the published patch may append /N to the name of any file 
that is not a SIL. 
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The module name designates the SIL module to be patched. You can obtain a 
list of SIL modules by pressing RETURN in response to the MODULE 
NAME question. The base address defines the actual locations to be patched. 
For instance, if you are patching the PRINT USING section of BASIC-PLUS, 
you would enter the symbol PU as the base address. The offset address is the 
first location to be patched relative to the specified base. For instance, a 
PRINT USING patch may begin at an offset of 100 octal bytes from the 
beginning of PRINT USING. 

Responses to the BASE ADDRESS and OFFSET ADDRESS questions can 
be numbers or expressions. Valid octal numbers are to 177777, and leading 
zeroes are optional. Valid decimal numbers are 0. to 65535., and are distin- 
guished from octal numbers by the presence of a trailing decimal point. When 
patching a SIL, you can substitute a global symbol name for an octal number. 
The symbol table for the module being patched is part of the SIL file. It 
contains that module's global symbol names and their values. A global sym- 
bol name must be one to six alphanumeric characters and must be defined in 
the symbol table for the current module. To refer to a global symbol in 
another module of the current SIL, type the symbol name followed by a 
commercial at sign @ and the name of the module in which the symbol is 
defined. For example, LOGIN@BASIC and DISK@ERR refer to the symbols 
LOGIN and DISK in the modules BASIC and ERR, respectively. An expres- 
sion consists of one or more numbers or global symbols, separated by arithme- 
tic operators (+,-,*, and /). Parentheses can be used to group portions of an 
expression. 

After you specify the base and offset addresses, PATCH opens the specified 
locations, prints the old contents, and accepts input. If the old contents do not 
match what is shown under 'Old' in the published patch, then you have made 
an error or the published patch is incorrect. Remove any changes you have 
already made and try again. Table 3-5 summarizes the possible input. 

Table 3-5: Possible Input to the PATCH option 



Input 


Meaning 


Number, symbol, or expression 


Enter the number, symbol, or expression as the new con- 
tents of the current location. 


© 


Advance to the next location without altering the contents 
of the current location. 


"(circumflex) 


Return to the previous location without altering the con- 
tents of the current location. 


(CTRL/Z) 


Return to the previous question. 


muQ 


Finish all patching and return to the OPTION: prompt. 



PATCH makes each specified change immediately after you press RETURN. 
Therefore, if you make an error, you must patch the location again to correct 
your mistake. To check that an entire patch is correct, type CTRL/Z to return 
to the OFFSET ADDRESS question. Type the same offset, then press LINE 
FEED to examine all the patched locations. 
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If the old contents listed for any location do not match the 'New' column in 
the published patch, restore all locations to their original contents and install 
the patch again. If you have followed the published procedures correctly and 
the old contents do not match the published patch, consult your software 
support representative. 

If you patch the initialization code, you must reboot the system. Rebooting 
loads the changed version of the initialiation code into memory. To perform 
the bootstrap procedure, follow the instructions in the published patch and 
use the BOOT option, which is described in Section 3.12. 

The examples in the following sections illustrate the use of PATCH. 

3.5.2 Patching the Monitor - Example 

The following example shows the procedure for patching the installed monitor 
SIL. The patch in this example is a sample only, NOT a real patch. 



a 


Option: 


PATCH 








b 


File to 


patch? 


© 






c 


Module 


name? OMR 






d 


Base address? 


DLNOST 






e 


Offset 


address 


? 300 








Base 


Offset 


Old 


N 


BW? 


f 


032000 


000300 


006200 


? 


4737 


S 


032000 


000302 


032711 


? 


PATCH+10 


h 


032000 


000304 


040000 


7 


"C 


i 


Option: 


PATCH 










File to 


patch? 


© 








Module 


name? RSTS 








Base address? 


PATCH 








Offset 


address? IQ 








Base 


Offset 


Old 


N 


3W? 




023 13G 


000010 


000000 


7 


G200 




023 13G 


000012 


000000 


7 


32711 




023 13B 


000014 


000000 


7 


40000 




023136 


000016 


000000 


7 


207 




023136 


000020 


000000 


7 


^C 




Option: 











Follow this explanation keyed to the letters that are located in the previous 
example: 

a. Specify the PATCH option, then terminate your response by pressing 
RETURN. 

b. Press LINE FEED to patch the installed monitor SIL. 

c. Respond to the MODULE NAME question with OVR. 

d. Enter the global symbol DLNOST in response to the BASE ADDRESS 
question. 

e. Specify 300 which represents the number of octal bytes offset from the base 
name DLNOST. 

f. Enter the new value. 

g. Type the new value which shows the use of additions. 



3-24 Tailoring the SYSGEN System 



h. Type CTRL/Z, echoed as "^C, to exit from the PATCH option. 

i. Notice the second use of the PATCH option continues the installation of 
this patch. 

3.5.3 Patching the Initialization Code - Example 

The following example shows the procedure for patching the initialization 
code. The patch in the example is a sample only, NOT a real patch. 



a 


DPTIONi 


- PATCH 








b 


File to patch? 


INIT»SYS 






c 


Base a i: 


ddress? DEFPAT 






d 


Offset 


address? 











Base 


Offset 


Old 


Ni 


ew? 




117002 


000000 


016700 


>^ 


4737 




117002 


000002 


177672 


'p 


1042B0 




1 17002 


000004 


042705 


? 


"2 


e 


Offset 


address? 


"Z 








Base address? 1042S0 








Offset 


address? 











Base 


Offset 


Old 


N( 


BW? 




104260 


000000 


000000 


7 


22127 




1042G0 


000002 


000000 


•ri 


UO 




1042G0 


000004 


000000 


'^ 


17375 




104260 


000006 


000000 


? 


105711 




104260 


000010 


000000 


1^ 


261 




104260 


000012 


000000 


'p 


207 




104260 


000014 


000000 


7 


"Z 


f 


Offset 


address? 











Base 


Offset 


Old 


N( 


3W? 




104260 


000000 


022127 


7 


© 




104260 


000002 


000040 


7 


© 


S 


104260 


000004 


017375 


•p 


© 




104260 


000006 


105711 


7 


© 




104260 


000010 


000261 


9 


© 


h 


104260 


000012 


000207 


? 


"C 




Option: 











The letters that prefix the explanation that follows are keyed to identifying 
letters located within the previous PATCH example. Follow the lettered steps 
through this sequence of steps: 

a. Specify the PATCH option, then terminate your response by pressing 
RETURN. 

b. Type the name of the file to patch which is in this case INIT.SYS, the 
system initialization code. 

c. Enter the base address of DEFPAT. 

d. Indicate an offset address of zero by typing 0. 

e. Note the use of CTRL/Z to return to the previous question. 

f. Enter the patch values and CTRL/Z to the OFFSET ADDRESS question. 

g. Press LINE FEED, after entering the patch, to examine successive loca- 
tions to ensure that the patch was properly installed. 

h. Type CTRL/C to terminate the patching operation and return to the 
OPTION: prompt. 
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3.5.4 PATCH Option Error Messages 

Table 3-6 summarizes the error messages that can occur during the PATCH 
option dialogue. 

Table 3-6: PATCH Option Dialogue Error Messages 



Message and Meaning 



ADDRESS ABOME MODULE BOUNDS 

The address you specified exceeds the upper bound of the module. 

ADDRESS BELON MODULE BOUNDS 

The address you specified is below the lower bound of the module. 

BLOCK OFFSET BEYOND EOF 

The block offset address you typed is greater than or equal to the num- 
ber of blocks in the file. 

FILE NOT FOUND 

The initialization code did not find the file you specified in account [0,1] 
on the system disk. 

ILLEGAL FILE NAME 

The filename you typed is in an incorrect format. The name must not be 
more than six characters long; the extension must not be more that 
three characters long. The filename must be alphanumeric and can not 
contain embedded spaces. Typing LINE FEED in response is illegal if 
no monitor SIL is installed. 

INUALID MODULE NAME 

The module name you typed is in an incorrect format. The name must 
be one to six alphanumeric characters. 

INMALID CHARACTER 

The expression line contains an illegal character. 

INMALID EXPRESSION 

The expression contains an illegal symbol name or an invalid operator. 
Symbol names must be one to six alphanumeric characters. Valid oper- 
ators are +, -, *, and /. 

INUALID SIL FORMAT 

The file you specified does not contain a valid SIL directory. If the file is 
not a SIL, append the /N switch to the filename. 

MODULE NOT FOUND IN SIL 

The module you specified is not in the SIL. Press RETURN in response 
to the MODULE NAME question for a directory of SIL modules. 

SYMBOL NOT FOUND IN STB 

A symbol you typed is not in the symbol table for the module. 
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3.6 Specifying tlie Hardware Configuration 

With the HARDWR option, you can perform the functions summarized in 
Table 3-7. The option operates whether or not you have installed a monitor 
SIL because the settings it affects are written on the system disk, not in the 
monitor SIL. Thus, when you add or remove system devices you must use the 
HARDWR option again. If you only change monitors, you need not use the 
option. This procedure differs from that of the DEFAULT and SET options 
which are described in this chapter. 

If you have not yet used the HARDWR option or have not used the INSTALL 
option to install a monitor on the system disk, the complete hardware configu- 
ration is not available. That is, the initialization code INIT.SYS has not yet 
scanned the entire hardware configuration. This prevents INIT.SYS from 
incorrectly treating devices at non-standard addresses. 

You can declare any non-standard device characteristics at this time by using 
the HARDWR suboptions you need. You can enter and verify changes, then 
exit from the HARDWR option. HARDWR will bootstrap the system disk; 
INIT.SYS will then scan the entire hardware configuration, applying the 
changes you have entered. 

The INIT.SYS message: 

ENABLING ONLY CONSOLE t DISKS » AND TAPES, 

indicates that the initialization code has completed only a partial scan of your 
system's configuration. The message occurs, for example, when you bootstrap 
INIT.SYS from the RSTS/E distribution medium. 

If you change no device characteristics, you can force INIT.SYS to scan the 
entire hardware configuration. To initiate the hardware scan, use the 
INSTALL option to install a monitor SIL, or use the HARDWR suboptions 
RESET and EXIT. Either of these options will reboot the system disk, if 
necessary, and cause INIT.SYS to perform a complete hardware scan. 

The HARDWR option includes a set of suboptions, which are summarized in 
Table 3-7. 

The LIST suboption lists the current configuration and all requested changes. 

The ENABLE and DISABLE suboptions allow you to enable or disable a 
device controller, not just a single unit. By disabling the RK611 or RK711 
(RM) controller, for example, you disable all RK06 and RK07 disk units. To 
disable or enable devices on a unit-by-unit basis, see Section 3.10. 

The CSR suboption enables you to set non-standard values for a device 
controller's CSR set. The Control Status Register (CSR) set is the unique set 
of addresses on the UNIBUS to which a device controller responds. When the 
initialization code is bootstrapped, it ascertains the number of each type of 
controller on the system by applying standard rules for finding CSR sets. 
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DIGITAL Field Service representatives follow these rules when they install 
systems; thus, you probably will not need to use the CSR suboption. Refer to 
Appendix C for a brief discussion of the hardware checks performed by the 
initialization code. 



Table 3-7: HARDWR Suboptions 



Suboption 


Function 


LIST 


Lists the system hardware configuration. 


DISABLE 


Disables a device controller. 


ENABLE 


Enables a device controller. 


CSR 


Declares a non-standard controller address. 


VECTOR 


Declares a non-standard vector assignment. 


RESET 


Sets all vectors and addresses to the standard and enables all devices. 


DM 


Declares DMll-BB and DHll associations. 


TU58 


Associates a TU58 with a controller. 


UNITS 


Associates a disk type with a controller. 


HERTZ 


Specifies AC line frequency of system. 


SWITCH 


Specifies CPU Switch Register characteristics. 



With the VECTOR suboption, you can specify a non-standard vector for any 
device controller. A controller vector assignment directs the processor to the 
proper routines when that controller requests an interrupt. When you boot- 
strap the system, the initialization code ascertains each device controller's 
vector assignment by forcing each device to interrupt. If a device does not 
respond, the initialization code prints a message at the console terminal and 
disables that device. If more than one device has the same vector assignment, 
the initialization code prints a message and disables all except the first one it 
finds. Because the initialization code can find the vector address of most 
functioning hardware, even if the vector is non-standard, the VECTOR 
suboption should not normally be used except for non-DIGITAL hardware 
and for card readers with non-standard vectors. 

The RESET suboption returns all CSR settings and vector assignments to the 
standard addresses, enables all devices, and associates each DMll-BB unit 
with the DHll multiplexer that has the same unit number. If you have no 
HARDWR changes, you can use RESET. This will cause INIT.SYS to reboot 
the system device and execute a full configuration scan. 

The DM suboption allows you to specify the DMll-BB modem control multi- 
plexer that is associated with each DHll terminal multiplexer. In a similar 
manner, the TU58 suboption allows you to specify the TU58 cassette tape 
drive that is associated with each DLll terminal interface. 
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The HERTZ suboption allows you to specify the AC line frequency of your 
system, and the SWITCH suboption allows you to specify the characteristics 
of your system's CPU Switch Register. 

To use the HARDWR option, type HARDWR or HA. In response, the option 
requests a suboption name. Type the name of a suboption from Table 3-7. 
You need to type only the first two characters. HARDWR then performs the 
dialogue (if any) for the suboption you selected. If you indicate any changes to 
the controller characteristics, HARDWR does not affect them immediately. 
Instead, it applies them after you exit from the HARDWR option, when it 
bootstraps the system disk. Thus, you can verify the accuracy of the changes 
before the HARDWR option applies them. If you have made any errors, you 
can correct them before HARDWR applies them. 

After you have made and verified the changes you need, type EXIT or press 
LINE FEED in response to the HARDWR SUBOPTION question. HARDWR 
effects the changes, bootstraps the system disk, and prints one of the following 
messages: 

Message and Meaning 

OPTION: 

You have made no HARDWR changes; also, the initialization code has 
previously completed a scan of the system's hardware configuration. 

nn CHANGES PENDING 
REBOOTING*** 

You have made nn changes which will be implemented by the initiahza- 
tion code when it bootstraps the system disk. A complete hardware scan 
is done as the system reboots. 

ENABLING ALL DEUICEB* 
nr. CHANGES PENDING 
REBOOTING 

The initialization code has previously completed only a partial scan of 
the system's hardware configuration. You have made nn changes (or 
have used the RESET suboption). The changes are now applied by the 
initialization code, and a complete hardware scan is done as the system 
reboots. 

To exit from the HARDWR option without applying any changes, type 
CTRL/C. The CTRL/C response returns you to the OPTION: prompt. 

Questions in the DISABLE, ENABLE, CSR, and VECTOR suboptions re- 
quest the name of a controller. To get a list of valid controller names, type a 
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question mark (?) in response to the question. The suboption responds with 
the following list: 



Name Max 

TT 

RF 

RS 

RK 

RL 

RM 

RP 

RR 

RB 

TM 

TU 

TS 

TC 

PR 

PP 

LP 

RX 

CR 

CD 

KL 

DL 

DE 

DP 

DC 

KG 

DM 

DJ 

DH 

DU 

Dl 

XM 

)<K 

DZ 



IB 

3 

3 

3 

32 

8 
IB 
IB 
IB 
18 
IB 
IB 
IB 

8 



DescriPti on 

Console terminal 

RFll fixed head disK 

RS03/RS04 fixed head disK 

RK05/RK05F disk 

RL01/RL02 disK 

RK0B/RK07 disK 

RP02/RP03 disK 

RM02/RM03 disK 

RP04/RP05/RP0B disK 

TU10/TE10/TS03 magtape 

TU1B/TE1G/TU^5/TU77 magtape 

TS04 magtape 

TCll DECtape 

Paper tape reader 

Paper tape punch 

Line printer 

RXll floppy disk 

CRll/CMll card reader 

CD 11 card reader 

KLll/DLllA/DLl IB single 

DLllC/DLllD sinj?le line 

DLllE single line interface 

D P 1 1 synchronous line interface 

D C 1 1 single line modem interface 

KG 11 CRC arithmetic unit 

DMll-BB modem control for DHll 

D J 1 1 18 line multiplexer 

DHll IB line multiplexer 

D U 1 1 single line synchronous interface 

DUPli single line synchronous interface 

DMCll interprocessor link 

KMCll microprocessor 

D Z 1 1 8 line multiplexer 



line interface 
interface 



The first column contains the controller names. The second column, Max no., 
is the maximum number of each type of controller that can be used by 
RSTS/E. The final column describes the controller. 

Your reply to a request for a controller should be a 2-character controller 
name followed by the number of the controller you plan to change. Controllers 
are numbered from to the maximum possible number of controllers minus 1. 
You can omit a controller number of if only one such controller is possible. 
For example, RK and RKO are equivalent responses because a PDP-11 can 
have only one RK05 controller. On the other hand, LP and LPO are not 
equivalent. LPO designates line printer controller number 0; LP is invahd 
because more than one line printer controller can be on the system. 

To exit from a suboption without specifying a controller name, type CTRL/Z 
in response to the question. 

Controller characteristics set by the HARDWR option remain with the disk 
device rather than with the RSTS/E Monitor. Therefore, when you install a 
different monitor on the same system disk, you need not reset the device 
controller characteristics. If you create and subsequently bootstrap a new 
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system disk, however, the initialization code sets all controller characteristics 
to the standard values and then performs only a partial configuration scan. 
Thus, if it is necessary, you will need to use the HARDWR option to set non- 
standard characteristics. 



3.6.1 Listing the Hardware Configuration 

The LIST suboption prints the current hardware configuration table, includ- 
ing all changes that HARDWR will apply when you exit from the option. The 
following is a sample listing: 



HARDWR suboption? LI 




1 change pend 


i n ^ . 




Name 


Address 


M e 1 r 


C (Ti m e n 1 5 


TT: 


1775B0 


OBO 




RS! 


172040 


204 


Units: 0(RS04) 


RK: 


177400 


220 


RK05F units: none 


RB: 


17G700 


254 


Units: (RP04) 


TU: 


172440 


224 




TC: 


177340 


214 




LPO: 


177514 


200 




(LPO: 


S y 5 t e m 




Disabled) 


DLO: 


175B10 


310 




DLl : 


175B20 


320 




DL2: 


175G30 


330 




DL3: 


175G40 


340 




KGO 






Disabled 


DM0 ! 


170500 


474 




DHO: • 


itlBOlOO 


*500 




DHl: ■ 


*1B0120 


*510 




DUO: 


IBOOBO 


400 




KWllL 


17754B 


100 




KWllP 


172540 


104 




SR 


177570 






DR 


177570 






Hertz 


= BO, 






Other 


: FPU* SL 




H a r d w r suboption? 





The top line lists the number of changes that HARDWR will implement when 
you exit from the option. If no changes are pending, the LIST suboption omits 
this line. 

Next, LIST prints the hardware Configuration Table. It contains one line for 
each device controller that exists on the system. The table also contains an 
additional line, printed in parentheses, for each controller that has changes 
pending. This line appears whether or not the controller has a listing line. 
Thus, if you declare a non-standard characteristic for a controller that does 
not yet exist on the system, HARDWR prints a parenthetical change line 
noting the change. In addition, the table contains a line for controllers that 
are currently either disabled or nonexistent. 



Tailoring the SYSGEN System 3-31 



Each line is divided into four columns. The first column contains the name 
and number of the device controller. The second includes the address of the 
controller's CSR set and the third contains the controller's vector address. 
Note that, if the device has two vectors, HARDWR prints the lower address; 
an asterisk (*) precedes a CSR or vector address that is non-standard. 

In a parenthetical change line, the Address column contains either a non- 
standard address or the notation SYSTEM. This notation means that the 
initialization code will find the CSR set according to the standard fixed and 
floating address rules when it bootstraps the system disk. (See Appendix C for 
a discussion of fixed and floating address rules.) The third column in a change 
line is blank or contains a non-standard vector address that you specified. 

The fourth column, for any line, supplies information about the controller. 
Table 3-8 summarizes the comments that may be in the listing for each 
controller. 

Following the device table there are several lines of information. The informa- 
tion reported will vary with the system configuration and the changes (if any) 
you have made to the configuration. 



The information reported is: 
Mnemonic 



Line and Meaning 



KWll-L 



KWll-P 



SR 



SR 



(SR 



DR 

HERTZ 50 
60 

(HERTZ = 50 ) 
60 

CIS 

FPU 

FIS 

SL 

MED 



177546 100 

If the system has a KWll-L clock, its address and vector are 

reported. 

172540 104 

If the system has a KWll-P clock, its address and vector are 

reported. 

177570 

VOLATILE 

DISABLED 

If the CPU has a Switch Register, its address is reported. If you have 

used the SWITCH suboption to specify Switch Register VOLATILE or 

DISABLED, that choice is reported. 

VOLATILE 

DISABLED 

The CPU does not have a Switch Register, but you have used 

SWITCH suboption to ENABLE or DISABLE it. 

DISABLED ) 

ENABLED 

VOLATILE 

There is a pending change from SWITCH suboption. 

177570 

If the CPU has a Display Register, its address is reported. 

The system's AC line frequency is always reported. 

There is a pending change to the system's AC line frequency. 

The CPU has the Commercial Instruction Set option. 

The CPU has the Floating Point Processor option. 

The CPU has the Floating Instruction Set option (PDPll/40 only). 

The CPU has a stack limit register. 

The CPU has the Maintenance Examine/Deposit instruction. 
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Mnemonic 

CACHE 

CACHE W/ADDRESS 
22-BIT ADDRESSING 
SYSTEM ID = nnnnn 



Line and Meaning 

The CPU has main memory cache. 

The CPU retains address information upon a memory fault. 

The CPU supports more than 124KW of memory. 

The contents of the CPU identification register are reported, if the 

register exists. 



Table 3-8: Possible Comments in the Configuration Listing 



Device 



Comment and Meaning 



ALL 
ALL 

RF 
RS 



RK 



RL 



RM 



RP 



RB,RR 



Disabled 

Device is (or will be) disabled. 

Not found 

Device has a non-standard CSR set, but did not respond when you last 

bootstrapped the system. 

n platters 

n is the number of disk platters present. 

BAE=+xxx 

BAE indicates that the device controller supports 22-bit addressing and has a Bus 

Address Extension register at the specified offset from its CSR base. 

units: m...t 

m through t are unit numbers of drives that exist on the controller (8 are possible). 
In parentheses after each unit number is the disk type. Following the disk type is 
IL, if that unit interleaves sectors. 

RK05F units: n/m 

n and m are the even and odd unit numbers of the RK05F drive. 

RK05F units: none 

No RK05F units are on the system. 

units: m(RLOl)... 

p(RLOl) 
m through p are unit numbers of drives that exist on the controller (4 are 
possible). In parentheses after each unit number is the disk type. 

units: m(RK07)... 

t(RK07) 
m through t are unit number of drives that exist on the controller (8 are possible). 
In parentheses after each unit number is the disk type. 

RP03 units: m...t 

m through t are unit numbers of RP03 disks, (note that 8 units are possible.) Unit 

numbers of RP02 drives are not listed. 

BAE=+xxx 

BAE indicates that the device controller supports 22-bit addressing and has a Bus 

Address Extension register at the specified offset from its CSR base. 

units: m(RM02)... 

t(RM02) 
m through t are unit numbers of drives that exist on the controller (8 are possible). 
In parentheses after each unit number is the disk type. Following the disk type is 
DP, if that unit is a dual-ported disk. 



(continued on next page) 
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Table 3-8: Possible Comments in the Configuration Listing (Cont.) 



Device 



Comment and Meaning 



TU 



DM 



DE, 
DL, 
KL 



BAE=+xxx 

BAE indicates that the device controller supports 22-bit addressing and has a Bus 
Address Extension register at the specified offset from its CSR base. 

units: m(TU16@TM02?;^X)... 

t(TUl6@TM02#X) 

m through t are unit numbers of drives that exist on the controller (8 are possible). 
In parentheses after each unit number are the tape type, formatter type, and the 
formatter number. The TU16, TE16, TU45, and TU77 represent the valid device 
types for the TU controller and the TM02 and TM03 are the valid formatter 
types. The formatter number (^X) can be any number from to 7. 

DHn 

DHll controller number n is logically associated with this DMll-BB unit. 

No DHll 

No DHll controller is logically associated with this DMll-BB unit. 

units: m(TU58)... 

t(TU58) 

m through t are unit numbers of DLll controllers that have TU58 cassette tape 

drives connected to them. 



3.6.2 Disabling a Device Controller 

The DISABLE suboption allows you to make a device controller unavailable 
for time-sharing use. This suboption has two possible uses: (1) to disable 
a controller that needs repairs, and (2) to disable an erroneously detected 
controller. In certain circumstances, the initialization code interprets a 
non-standard device as a normal PDP-11 device, and therefore enables the 
standard PDP-11 device. With the DISABLE suboption, you can disable the 
non-existent PDP-11 device. 

The following is an example of the DISABLE suboption: 

HARDWR suboption? DIS 

Controller to disable? DM0 
HARDWR suboption? LIST 
2 changes pending. 



Name 


Address 


i.) e c t r 


CodHrient 5 




TT: 


1775G0 


OGO 






RF: 


177aG0 


204 


2 platters 




RK: 


177400 


220 


RK05F units 


n n e 


RP: 


17G700 


254 


RP03 units: 


1 


TM: 


172520 


224 






TC: 


177340 


214 






PRO: 


177550 


070 






PPO: 


177554 


074 






LPO: 


177514 


200 
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DPO: 






Disabled 


( D P : 


S y 5 1 e M ) 






DM0: 


170500 


300 




(DM0: 


S y 5 t e m 




Disabled) 


DHO: 


1 BOO 20 


310 




KWllL 


17754G 


100 




KWllP 


172540 


104 




SR 


177570 






DR 


177570 






Hertz 


= GO. 






Other: 


FPUt SL 







HARDWR suboption? 

In the example, you specify DM0 as the device controller to disable. The 
initialization code executes the DISABLE suboption and returns to the 
HARDWR SUBOPTION question. You then specify the LIST suboption to 
verify that DM0 will be disabled when you exit from the HARDWR option. 

3.6.3 Enabling a Device Controller 

Use the ENABLE suboption to enable a disabled device controller. The fol- 
lowing example illustrates the use of the ENABLE suboption: 

HARDWR suboption? ENABLE 

Controller to enable? DPO 
HARDWR suboption? LIST 
1 c h a n jS e pending. 



Name 


Address »,' 


e t r 


C m rt> e n t 5 


TT: 


1775G0 


OGO 




RF: 


177460 


204 


2 platters 


RK: 


177400 


220 


RK05F un its: none 


RP: 


17G700 


254 


RP03 units: 1 


TM: 


172520 


224 




TC: 


177340 


214 




PRO: 


177550 


070 




PPO: 


177554 


074 




LPO: 


177514 


200 




DPO: 






Disabled 


(DPO: 


S y 5 t e (ti ) 






DM0: 


170500 


300 




DHO: 


1G0020 


310 




KWllL 


17754G 


100 




KWllP 


172540 


104 




SR 


177570 






DR 


177570 






Hert2 


= GO. 






Other: 


1 FPUf SL 







HARDWR suboption 



In the example, you enable the DPO controller. When the initialization code 
returns to the HARDWR SUBOPTION question, you initiate a list of the 
hardware configuration to verify the change. 
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3.6.4 Declaring a Non-Standard Controller Address 

The CSR suboption allows you to specify a non-standard address for a device 
controller's CSR set. Use the CSR suboption when a controller is installed at 
the wrong place or when you need to rearrange device controller assignments. 

To invoke the CSR suboption, type CSR. The suboption responds by request- 
ing a controller name and address. In response, type the controller name as 
described in Section 3.6. When the CSR suboption prints the question, type 
the address of the lowest register in the controller's CSR set. The address 
must be an even 6-digit octal number greater than 160000. To remove a non- 
standard address and revert to the standard setting, type RE or REMOVE 
instead of a response. 

To return to the HARDWR SUBOPTION question without specifying a new 
address, type CTRL/Z. 

The following example shows the use of the CSR suboption: 

HARDWR suboption? qsr 

Controller with non-standard address: d h 
New controller address? JGOIOO 

HARDWR suboption? lI 
1 c h a n £( e pending. 



Name 


Address U 


3 c 1 r 


C m (ii e r 


ts 


TT: 


1775G0 


OGO 






RS: 


172040 


204 


Units : 


0(RS04) 


RK: 


177400 


220 


RK05F 


u nits: n o r 


RB: 


176700 


254 


Units : 


0(RP04) 


TU: 


172440 


224 






TC: 


177340 


214 






LPO: 


177514 


200 






DLO: 


175G10 


3 1 






DLl : 


175G20 


320 






DL2: 


175G30 


330 






DL3: 


175G40 


340 






KGO: 


170700 








DM0: 


170500 


474 






(DHO: 


*1G0100) 








DUO: 


IGOOGO 


400 






KWllL 


17754G 


100 






KWllP 


172540 


104 






SR 


177570 








DR 


177570 








Hertz 


= GO. 








Other: 


FPU» SL 








HARDWF 


5 u b p t i 1 


■1? 







In this example, you request the CSR suboption, type DHO as the controller, 
and specify a new address of 160100. To verify the address change you then 
request the LIST option. 
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3.6.5 Declaring a Non-Standard Vector Address 

The VECTOR suboption permits you to specify a non-standard vector address 
for a device controller. Use VECTOR if the initialization code incorrectly 
determines a controller's vector address or if the hardware configuration in- 
cludes more than one card reader or paper tape reader. 

If you have a non-standard device controller, DIGITAL strongly recommends 
that you use only the CSR suboption. This tells INIT.SYS to find the device 
at its non-standard UNIBUS address, but still lets INIT.SYS determine the 
device's vector. If the device is functioning properly, INIT.SYS will find the 
device's non-standard vector. INIT.SYS can determine the vector locations 
for all devices except card readers and high-speed paper tape readers. If one of 
these devices has a non-standard vector, you must use the VECTOR subop- 
tion to specify its vector location. 

You must be careful when assigning non-standard vectors to devices. 
INIT.SYS checks all device vectors assigned through the VECTOR suboption 
or determined automatically, against a table of reserved locations. INIT also 
determines if a vector location is used by more than one device. It if finds any 
conflict, INIT.SYS prints the message: 

M e c t r for D e u i c e )< )< n : ( m mm) a 1 r e a d v in use - d e m i c e disabled. 

where vvv is the octal address of the erring vector. 

The RSTS/E reserved locations, which may not be used as device vectors, are: 

Address RSTS/E Usage 

0-2 Detection of jumps to and traps to 0. 

4-36 System trap vectors. 

40-56 Reload start addresses, failure HALT. 

100-102 KWll-L line frequency clock vector. 

104-106 KWll-P programmable crystal clock vector. 

110-112 Jump to handling. 

114-116 Memory parity trap vector. 

144-146 Crash dump handling. 

234-236 Statistics handling. 

240-242 PIRQ trap vector. 

244-246 FPP or FIS exception trap vector. 

250-252 Memory Management Unit trap vector. 

VECTOR requests the device controller's name and its new vector address. 
Type the name as described in Section 3.6. The vector address is the 3-digit 
octal address of the lowest vector for the device controller. The address must 
be even. To remove a non-standard vector address and return to the standard, 
type RE or REMOVE. Type CTRL/Z to return to the HARDWR 
SUBOPTION question without specifying a new vector address. 
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The following is an example for the VECTOR suboption: 

HARDWR suboption? gEC 

Controller with non-standard u e c t o r ? D H 
New uector address? 500 

HARDWR suhoption? LI 

1 change pending. 



Name Address 


e c 1 r 


C m ri) e n t s 


TT: 


1775B0 


OGO 




RS: 


172040 


204 


Units: (RS04) 


RK: 


177400 


220 


R K 5 F units: no n e 


RB: 


17B700 


254 


Units: (RP04) 


TU: 


172440 


224 




TC: 


177340 


214 




LPO 


177514 


200 




DLO 


175G10 


310 




DLl 


175G20 


320 




DL2 


175S30 


330 




DL3 


175G40 


340 




KGO 


170700 






DM0 


170500 


474 




(DHO 


*1G0100 


*500) 




DUO 


IGOOGO 


400 




HARDl' 


JR suboption? 





In this example, you have already set a non-standard controller address for 
DHO. The next task is to set a non-standard vector address for DHO. In 
response to the NEW VECTOR ADDRESS: question, you type 500, then list 
the configuration to , verify the vector address. 

3.6.6 Resetting the Configuration 

The RESET suboption sets all device characteristics to the standards. It 
removes all non-standard CSR sets and vector addresses and enables all 
devices. The following example shows the effects of the RESET suboption. 

HARDWR suboption? LIST 
3 changes pending* 



Name 


Address 


M e 1 r 


C m m e n t s 


TT: 


1775G0 


OGO 




RF: 


177460 


204 


2 Platters 


RK: 


177400 


220 


R K 5 F units: none 


RP: 


17G700 


254 


RP03 units: 1 


TM: 


172520 


224 




(TM: 


S y s t e m 


*226) 




TC: 


177340 


214 




PRO: 


177550 


070 




(PRO: 


* 160002) 






PPO: 


177554 


074 




LPO: 


177514 


200 




DPO: 






Disabled 


(DPO: 


System) 






DMO: 


170500 


300 




DHO: 


1 BO 020 


310 
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HARDWR sub option: RESET 
HARDWR SLiboption? LIST 
1 change p e n d i n <3 ♦ 



Name 


Address 


M e c 1 r 


Comdient s 




TT; 


1775G0 


OGO 






RF: 


1774G0 


204 


2 platters 




RK: 


177400 


220 


RK05F units: 


n n e 


RP: 


17G700 


254 


RP03 units: 1 


TM: 


172520 


224 






TCs 


177340 


214 






PRO: 


177550 


070 






PPO: 


177554 


074 






LPO: 


177514 


200 






DPO: 






Disabled 




DPO: 


S y s t e fii ) 








DM0: 


170500 


300 






DHO: 


1G0020 


310 







HARDWR suboption? 

For the purposes of this example, the LIST suboption is used before and after 
the RESET suboption to show the effects of resetting the configuration. The 
first Hsting shows that two devices (TM: and PRO:) would have non-standard 
addresses and vectors set if you were to exit from the HARDWR option. A 
third device, DPO:, is disabled and would be enabled with a standard address 
and vector. After the use of the RESET suboption, the listing shows that TM: 
and PRO: have returned to standard characteristics. Note that the listing for 
DPO: did not change because DPO: was already designated to be enabled with 
standard characteristics. 

3.6.7 Declaring DM11-BB and DH11 Associations 

The DM suboption allows you to specify the DMll-BB modem control multi- 
plexer that is associated with each DHll terminal interface multiplexer. The 
DHll terminal interface multiplexer has 16 lines (which are numbered from 
to 15), any number of which can be modem lines. A PDP-11 can have up to 16 
DHlls. The DMll-BB modem control multiplexer also has 16 lines. Each 
line can answer one modem line on a DHll. A PDP-11 can have only as many 
DMll-BBs as DHlls. 

DMll-BB modem control lines and DHll modem lines must meet the follow- 
ing conditions under RSTS/E: 

1. A DMll-BB can answer modem lines on only one DHll. 

2. A DHll can be associated with only one DMll-BB. 

3. The line numbers of the DHll modem line and its associated DMll-BB 
line must be the same. For example, a DMll-BB line number 4 can 
control only a DHll modem line number 4. 

The RSTS/E software cannot ascertain which DMll-BB unit is associated 
with a DHll. Therefore, RSTS/E assumes that DMll-BB unit number 
controls modem lines on a DHll unit number 0, and so forth. On most sys- 
tems, the unit numbers are equal. RSTS/E does not, however, require that 
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DHll and DMll-BB unit numbers be equal. Thus, DMll-BB unit number 2 
can control modem lines on DHll unit number 4, as long as the preceding 
rules are followed. 

If you want a different association, the DM suboption allows you to specify 
the DMll-BB unit that is associated with each DHll on the system. The 
suboption requests the DMll-BB unit number in the following prompt: 

DH FOR DMn (xkx)? 

In response, type the number of the DHll unit with which DMll-BB unit 
number n is associated or press LINE FEED to accept the current setting, 
which appears in parentheses. If no DHll is currently associated with the 
DMll-BB, a question mark (?) appears in parentheses. If DMll-BB unit n is 
not on the system the notation NX (for nonexistent) appears in parentheses. 
HARDWR requests DHll unit numbers for all 16 possible DMll-BB units 
whether or not the system includes 16 units. Therefore, you can logically 
associate a DHll unit with a DMll-BB that is not yet on the system, but is 
expected in the future. You need not specify associations for nonexistent 
DMll-BBs; you can type CTRL/Z at any time to return to the HARDWR 
SUBOPTION question. Note, however, that CTRL/Z causes the system to 
make no associations for the remaining DMll-BB units, and cancels the 
assumption that DHn is associated with DMn. 

The following is an example of DM: 

HARDWR suboption? DM 
DH for DM0 (0) ?© 
DH for DM1 ( 1 » NX)? "7 



r. O 



HARDWR suboptionT 

In the example, you associate DHO with DM0, and then make no more associ- 
ations because the system includes only 1 DHll and 1 DMll-BB. 

3.6.8 Declaring DL11 Associations 

You use the TU58 suboption to specify the DLll single line terminal interface 
controller that is associated with each TU58 cassette tape drive. The initiali- 
zation code will scan all DLll interfaces to determine which controllers have 
TU58's connected to them. Usually this will be sufficient to allow you to use 
TU58s on your system. 

To associate a DLll controller with a TU58 tape drive, you enter the DLll 
controller name and unit number in response to the following prompt: 

DL for DDn (xxx)? 

If you want to accept the default setting that appears in parentheses, press 
LINE FEED. The suboption prints a question mark (?) if there are no DLlls 
associated with a TU58. HARDWR requests DLll unit numbeirs for all 8 
possible TU58's whether or not they were found on the system. You can type 
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CTRL/Z if you do not want to specify associations for nonexistent TU58s. A 
CTRL/Z response instructs the system to make no associations for the remain- 
ing TU58 units. 

The following example illustrates the use of the TU58 suboption: 

HARDWR SLiboption? TU58 
DL for DDO (DLO)? (ST) 

Type the controller and unit number of the DLll controller to associate with 
this TU58. Press LINE FEED to use the unit number indicated. Type 
CTRL/Z if there are no more TU58s. 



DL for 


DDO (DLO)? 


DL for 


DD2 (?)? (0 


DL for 


DDa (?)? (D 


DL for 


DDG (?)? (D 


HARDWR 


s u b p t i n ? 



In the example, you press RETURN to learn how the INIT dialogue wants you 
to respond. After the message prints, you accept the default DLO setting by 
pressing LINE FEED. Since no other TU58's exist on your system, you press 
LINE FEED to the remaining questions. A CTRL/Z to the DL FOR DD2 
prompt would have returned you to the HARDWR suboption prompt sooner. 

3.6.9 Specifying AC Line Frequency 

The HERTZ suboption allows you to specify the correct AC line frequency of 
your system. Since the AC line frequency is the basis for all system timing, 
you will need to use the HERTZ suboption if the LIST suboption shows an 
incorrect line frequency. 

To use the HERTZ suboption, type HERTZ in response to the HARDWR 
SUBOPTION question. The prompt returned is: 

NEW AC LINE HERTZ? 

Type 50 if your AC line frequency is 50 Hz (commonly used in the United 
Kingdom); Type 60 if your AC line frequency is 60 Hz. 

3.6.10 Specifying CPU Switcli Register Characteristics 

The SWITCH suboption allows you to specify the characteristics of your 
CPU's Switch Register. You define the characteristics of your CPU's Switch 
Register by typing SWITCH in response to the HARDWR SUBOPTION 
question, then typing ENABLE, DISABLE, or VOLATILE in response to the 
following question: 

BWITCH REGISTER? 

The SWITCH suboption categories are defined in Table 3-9. The system uses 
the characteristics you specify to determine procedures for recovery after a 
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power failure or other types of system crashes. For related information, refer 
to the RSTS/E System Manager's Guide. 

Table 3-9: SWITCH Suboption Responses 



Response 



ENABLE 



DISABLE 



VOLATILE 



Meaning 



Your CPU Switch Register has 2-position toggle switches and you want to use 
them to control: 

a) Automatic Restart after a system crash. 

b) The optional Monitor Statistics Gathering Package. 

To enable Automatic Restart all switches must be in the up position. Enable 
the Monitor Statistics Gathering Package by placing switches and 15 in the 
up position. 

Your CPU has no Switch Register, or you wish to prevent the Switch Register 
Control of: 

a) Automatic Restart. 

b) Statistics. 

RSTS/E will behave as if all switches are always down. 

Your CPU Switch Register is volatile; that is, it loses its contents upon a 
power failure. If RSTS/E encounters a power failure, it will ignore the Switch 
Register and will always reboot and perform an automatic restart. Note that a 
volatile Switch Register does control restarts after other types of system 
crashes and does control Monitor Statistics. 



3.6.11 Using the UNITS Suboption 

You can use the UNITS suboption to instruct the system to consider a disk a 
valid device even when the disk is disabled. Usually, if a disk malfunctions, 
you must power the drive down, bring it off-line, and call field service to 
rectify the problem. If RSTS/E should go down and then come up again 
during the time the disk is being repaired, the initialization code resets the 
hardware configuration table to indicate that the device is no longer part of 
the system configuration. Thus, when the disk becomes operational and you 
need to reestablish it as part of the system, you must bring RSTS/E down and 
then up again to allow the initialization code to update its configuration table. 
This process permits the initialization code to acknowledge the reappearance 
of the previously disabled device and thereby add the device to its configura- 
tion table. To prevent having to reset the table by bringing the system down, 
use the UNITS suboption to identify the names of those disks which are to 
remain permanently in the configuration table. The disks that you specify 
with the UNITS suboption will not be deleted from the table even if the 
devices become disabled. 

To invoke the UNITS suboption, type at least the first two letters of the word 
UNITS in response to the HARDWR option prompt, then press RETURN. 
The HARDWR option responds by printing the following question: 

DISK TO SET UNITS FOR? 
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The question asks you for the two character device mnemonic of the disk you 
want either to 1) remain permanently in the system configuration table or 
2) delete from the permanent configuration table. Press RETURN to receive a 
list of legal disk device mnemonics if you do not know what they are. The list 
that the initialization code prints contains these device mnemonics: DS, DK, 
DL, DM, DP, DR, and DB. When you have decided which disk to use, type its 
mnemonic and press RETURN. The question the initialization code asks next 
appears as follows: 

UNIT? 

Type the device unit number which is any number in the range from to 7, 
and terminate your response by pressing RETURN. UNITS next asks you for 
the disk device type in the following question: 

TYPE OF THIS UNIT? 



Since several disk types can be associated with one disk device mnemonic, the 
UNITS suboption requires that you specify the type of disk. Press RETURN 
for a list of all valid responses. For example, a legal response for DB disks is 
RP06. If the unit is currently attached to the system, the easiest answer is 
LINE FEED which specifies the attached device. In this case, the following 
questions do not appear. Also, rather than specifying a disk type, you can type 
the word REMOVE to delete the device reference you specified previously. 
This is the procedure you must follow to allow INIT to disable a disk that you 
previously specified UNITS for. After you terminate a disk type with the 
RETURN key, the UNITS suboption asks the following question if your re- 
sponse to the TYPE OF THIS UNIT question was DR or DB. 

DUAL-PORTED? 

If you respond to this question by pressing RETURN, the initialization code 
prints the explanatory message: 

Can this d r i m e be accessed by more than one computer? 

Even though RSTS/E is not able to use the dual-ported feature of these disks, 
it needs to know whether RM02/RM03 or RP04/RP05/RP06 disks are dual- 
ported, in order to recognize them when they come on-line. 

If the device type response to the TYPE OF THIS UNIT question was RS03 or 
RS04, then UNITS asks the next question: 

INTERLEAVED? 

If the RS03 or RS04 disk that you specified is interleaved, type YES or Y then 
press RETURN. Otherwise, type NO or N, then press RETURN. This infor- 
mation is used to recognize the disk when it comes on-line. 
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3.6.12 HARDWR Option Error Messages 

Table 3-10 summarizes the error messages that can occur during the dialogue 
of the HARDWR option. 

Table 3-10: HARDWR Option Error Messages 



Suboption 


Message and Meaning 


CSR 


ADDRESS MUST BE AN EUEN OCTAL NUMBER GREATER THAN 




IBOOOO, 




You specified an invalid address. Type an address that meets the 




requirements. 


DISABLE 


CANNOT DISABLE CONSOLE TERMINAL 




You tried to disable the console terminal. 


DISABLE 


CONTROLLER ALREADY DISABLED 




You tried to disable a disabled controller. 


ENABLE 


CONTROLLER NOT DISABLED 




You tried to enable an enabled controller. 


DISABLE, 


CONTROLLER NUMBER MISSING 


ENABLE.CSR, 


You did not specify a controller number for a device that has multiple 


VECTOR 


controllers. 


DISABLE, 


CONTROLLER NUMBER MUST BE LESS THAN nn 


ENABLE,CSR, 


The controller number you typed is larger than the maximum of nn. 


VECTOR 




DM 


DHll ALREADY ASSIGNED TO A DMll-BB 




The DHll unit you specified is already assigned to a DMll-BB. 


DISABLE, 


INVALID CONTROLLER NAME 


ENABLE.CSR, 


The first two characters you typed did not name a valid device controller. 


VECTOR 


Type ? to obtain a list of valid controller names and try again. 


DISABLE, 


INi,'ALID CONTROLLER NUMBER 


ENABLE,CSR, 


The controller number you typed is not an integer. Type the number in 


VECTOR 


the correct format. 


DM 


INVALID RESPONSE 




The unit number you specified is not a decimal number from to 15. 


VECTOR 


SECTOR MUST BE AN E^'EN OCTAL NUMBER LESS THAN 1000, 




You specified an invalid address. Type an address that meets the 




requirements. 



3.7 Installing a Monitor 



Use the INSTALL option to designate the monitor Save Image Library (SIL) 
that you will use for time sharing. You can use INSTALL to change to a 
different monitor any time the initialization code is running. Therefore, you 
can retain more than one monitor on one system disk. After installing a newly 
generated monitor, you must use the DEFAULT option to set defaults for that 
monitor. The monitor that you install in this step is the default monitor for all 
operations until you use the INSTALL option again to install another monitor 
SIL. When you are generating a SYSGEN system, the name of the monitor 
you should install is SYSGEN. When you are generating a Target system, the 



3-44 Tailoring the SYSGEN System 



monitor has the name you specified during the configuration questions. 
Examples of the use of the INSTALL option follow. 

If you are using the INSTALL option for the first time on the current system 
disk and the initialization code has not yet completely scanned the hardware 
configuration, the INSTALL option will reboot the system disk and make 
a complete scan of the hardware configuration. A sample dialogue of this 
situation is: 

Option: INSTALL 

SIL? SYSGEN 

REBOOTING. . , 
RSTS i,'7,0 (DBO) 
Options 

To obtain a list of all SIL files in account [0,1], press RETURN in response to 
the SIL question. 

If the initialization code has already done a complete scan of the hardware 
configuration, the INSTALL option does not bootstrap the system disk. A 
sample dialogue of this situation is: 

Option: INSTALL 

SIL? RSTS 
Option; 

Thus, the INSTALL option prompts you for the name of the monitor SIL to 
install, performs consistency checks on the specified SIL, and bootstraps the 
system disk (when necessary). Execution of the INSTALL option takes 30-40 
seconds. Table 3-11 contains the error messages that can appear when you 
respond to the prompt. 

Table 3-11: INSTALL Option Dialogue Error Messages 



Message and Meaning 



FILE NOT FOUND 

The installation code did not find the SIL file that you specified on the 
system disk in account [0,1]. 

ILLEGAL FILE NAME 

The file name you typed is not one to six alphanumeric characters. 

INMALID SIL FORMAT 

The file you specified does not have a valid SIL index block. 



After you type a valid response, the option ascertains that the SIL you named 
contains all the necessary modules. If a module is missing or in an incorrect 
format, the INSTALL option prints an error message and returns to the 
OPTION: prompt. These error messages are explained in Appendix A. 
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If a monitor SIL file is already installed, the INSTALL option turns off cer- 
tain bits (in the [0,1] directory entry for that file) so that you can delete the 
old monitor file (and its default RTS and ERR files, if any). Next, for both a 
change of monitor and an entirely new system, the option turns on the proper 
bits to install the monitor SIL and records its name for use by the initializa- 
tion code. Finally, the option records any defaults that are already set for the 
newly installed monitor. The installation is then complete. 

3.8 Changing System File Allocation 

You can 1) list file status, 2) change system file allocation, 3) create and 
delete files in account [0,1], and 4) examine and update the bad block file with 
the REFRESH option. REFRESH operates only on disks that have been 
initialized with the DSKINT option (see Section 3.3). The REFRESH option 
also includes a CLEAN facility, which rebuilds a disk's storage allocation 
table (SATT.SYS) and checks the consistency of directories. 

If you are generating the first RSTS/E system on the current system disk, 
you must use REFRESH to create the required swapping file SWAP. SYS. 
REFRESH also creates additional swapping files, CRASH.SYS, OVR.SYS, 
ERR. SYS, and BUFF. SYS (which is required if the system will support 
DECtape). It allows you to position these files at specific places on a disk. File 
positioning and creation (except SWAP. SYS) are optional operations that can 
increase system speed and efficiency. 

Once you have generated a system, use the REFRESH option when system 
files need changes. For example, REFRESH permits you to add bad blocks to 
the bad block file on any disk. If you discover bad blocks, use REFRESH to 
allocate them to the bad block file. 

REFRESH can also allocate file space on nonsystem disks. For example, you 
can use REFRESH to allocate swapping space on a nonsystem disk (usually a 
fixed head disk). The REFRESH option can also allocate OVR.SYS and 
ERR. SYS files on auxiliary disks. 

3.8.1 Planning System Files 

Before you use the REFRESH option, you should plan which files to include 
in the system, how large to make them, and where to place them. REFRESH 
allows you to create the following files: 

• Swapping files - SWAP.SYS, SWAPO.SYS, SWAPl.SYS, SWAP3.SYS 
(SWAP2.SYS does not exist.) 

• OVR.SYS 

• ERR.SYS 

• BUFF.SYS 

• CRASH.SYS 
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If the SYSGEN and Target systems will be on the same (moving head) disk*, 
you can allocate all system files that you will need later for the Target system 
while you are tailoring the SYSGEN system. For example, you can allocate a 
SWAP. SYS file on the system disk at the size needed for the Target system 
instead of the minimal size file that the SYSGEN system uses. If you plan to 
use a fixed head disk for swapping files, the overlay code, and error message 
file, you can also REFRESH it while you are tailoring the SYSGEN system. If 
you allocate the files for the Target system when you tailor the SYSGEN 
system, you need not allocate them again after you install the Target monitor. 
You should use the REFRESH option after installing the Target monitor to 
list the. directory of the Target disk (Section 3.8.3) and ensure that the files 
are correctly allocated. Note that you need not allocate the Target system files 
v/hen you tailor the SYSGEN system; you can allocate them after you install 
the Target monitor if you prefer. 

If the SYSGEN and Target systems will be on different disks (or if the Target 
system will overwrite the SYSGEN system on a fixed head disk), you should 
not allocate Target system files while tailoring the SYSGEN system. When 
you use REFRESH in tailoring the SYSGEN system, create only the minimal 
file necessary for system generation - SWAP. SYS (at least 224 blocks). You 
can allocate Target system files later when you tailor the Target system 
(described in Chapter 5). 



3.8.1 .1 Planning the Swapping Files — The most important and time-consuming 
of the planning processes concerns the swapping files. You must answer the 
following three questions to properly plan the swapping files: 

1. How many swapping files does this sytem need? 

2. Where should the swapping files be placed? 

3. How large should each swapping file be? 

The cardinal rule for planning swapping files is to anticipate future growth. If 
you suspect that the system will someday require a larger swap maximum or 
job maximum than it currently requires, you should allocate enough swapping 
space to serve your future needs. You should try to reserve this space now 
because swapping files require contiguous space on a disk. Although you can 
create contiguous swapping files during time sharing (with the contiguous 
mode switch in an OPEN statement), DIGITAL does not recommend this 
procedure. Once many files have been allocated on a disk, space on that disk 
becomes fragmented. This fragmentation may cause difficulty in allocating 
contiguous swapping files of sufficient length. Furthermore, if you allocate 
extra contiguous swapping space, but expected growth does not occur, you can 
simply release the space for other use. 



*DIGITAL recommends this method only for large, moving head disks of the DM, DP, DR, or 
DB type. 
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RSTS/E can use swapping space in one to four swapping files, numbered from 
to 3. Swap file 2 is permanently assigned to the file SWAP. SYS on the 
system disk. The other swapping files (0, 1, and 3) can be associated with 
swapping files or non-file structured disks. You can specify these associations 
on-line by using the UTILTY program or the INIT.BAC system program. 
When you associate swapping files with swapping slots, DIGITAL recom- 
mends that you use the name SWAPO.SYS for swap file 0, SWAPl.SYS for 
swap file 1, and SWAP3.SYS for swap file 3. This manual follows that naming 
convention. 

In allocating swapping space, you should consider the way in which the sys- 
tem is used and the number of event-driven jobs on the system. (Event-driven 
jobs are not run unless a particular event occurs. Events that cause these jobs 
to be run are the end of a SLEEP or hibernation state, and the reception of a 
message.) 

The system scans the swap files whenever it needs to swap a job out of 
memory. The system places event-driven jobs in the first swap file with avail- 
able space that it finds during a "bottom up" scan (from swap file 3 to swap 
file 0). Since these jobs do not require frequent swapping, they can be 
swapped onto a slow or heavily used disk without noticeably degrading per- 
formance. The system performs a "top down" scan (swap file to swap file 3) 
when it swaps out a highly interactive job (one requiring frequent processor 
intervention). Whenever possible, highly interactive jobs should be swapped 
to the fastest area available. Figure 3-1 illustrates the swap file scanning 
procedures. 

You should also consider the system's disk configuration. If the system has 
only one disk, you need only create the one required swapping file, 
SWAP. SYS, on that disk. The file should be at least large enough to hold a 
number of jobs equal to the default job maximum. 

For a system with more than one disk, planning swapping files is more compli- 
cated. You need to choose the disk or disks on which to place the swapping 
files and calculate the size of each file. 

First, consider a system with both moving head and fixed head disks. Assume 
that the system disk is a moving head device. Unless you need the speed of 
access on a fixed head disk for other files (such as a frequently accessed data- 
base index), you should place all swapping files (except SWAP. SYS, which 
must be on the system disk) on a fixed head disk. If you can spare an entire 
fixed head disk, you can use it non-file structured as a single swapping unit. 
To do so, you should first use the DSKINT option to check the disk for bad 
blocks. If the disk contains no bad blocks, you need not use REFRESH on it; 
you can simply use INIT.BAC at start-up time to install it as a swapping unit. 
(Refer to the RSTS/E System Manager's Guide for a discussion of 
INIT.BAC.) Once you install it, RSTS/E can use the disk only as a swapping 
unit. Remember that a swapping file can extend across platter boundaries on 
a DF disk, but cannot extend across disk unit boundaries for other fixed head 
disks. 
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Figure 3-1: Swap File Scanning 



SWAP FILE 



SWAP FILE 1 



Scan for highly Interactive 
jobs begins with swap file 
and continues in this 
direction until space is found. 
Swap file should always be 
located on fastest swapping 
disk. 



SWAP FILE 2 
(SWAP.SYS) 



SWAP FILE 3 



For event-driven jobs, the 
scan begins at the highest 
numbered existing swap file 
and continues in this direction 
until space is found. 



DIGITAL recommends that, if at all possible, you place the files OVR.SYS 
and ERR. SYS on an initialized fixed head disk to increase system perform- 
ance. You can then use the remaining space on the disk for swapping. 

If the fixed head disk contains bad blocks, you can use it only as a file- 
structured unit. Use REFRESH to set up a swapping file on the disk. You can 
place other files on the disk if enough space remains. Note that the file 
SWAP.SYS must reside on the system disk and must be large enough for at 
least two jobs at size SWAP MAX. (The system requires this file as a place to 
swap a job when time sharing begins but before the other swapping files are 
installed.) Therefore, for a system that will swap all jobs onto a single fixed 
head disk, you must create two swapping areas: SWAP.SYS (which can be of 
minimal size) on the system disk, and SWAPO.SYS (which should be large 
enough to hold the default maximum number of jobs at size SWAP MAX) on 
the auxiliary fixed head disk. Also, it is advantageous to make SWAP.SYS 
large enough to swap all jobs so the JOB MAX does not have to be reduced if 
a swapping device goes down. 

If you cannot place all swapping files on a fixed head disk, you should consider 
the average number of jobs that will run on the system. If the system usually 
runs near the default job maximum, you should allocate as large a swapping 
space as possible on a fixed head disk. Name this file SWAPO.SYS if the fixed 
head disk is a nonsystem disk or SWAP.SYS if the fixed head disk is the 
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system disk. The system will swap highly interactive jobs into this file. You 
should also allocate a swapping file on a moving head disk. This file should 
have a high number (SWAP3.SYS if on a nonsystem moving-head disk or 
SWAP. SYS if on a moving head system disk) so that the system will swap 
event-driven jobs into it. 

Some systems usually run below the default job maximum with approxi- 
mately the number of jobs that fit into a swapping file on a fixed head disk. 
For such a system, you should first estimate the number of jobs that are 
inactive at any one time. Inactive jobs usually include ERRCPY, QUEMAN, 
OPSER, spoolers, and similar programs. Then, estimate the amount of swap- 
ping space necessary to accommodate any jobs over those that will fit on the 
fixed head disk up to the default job maximum. For example, if approxi- 
mately 18 jobs usually run on the system (and will fit on the fixed head disk), 
but the default job maximum is 25, calculate the amount of space necessary 
to accommodate the extra 7 jobs. (The 7 jobs require 7 times the SWAP MAX 
multiplied by 4 blocks. Four blocks equal 1024, or IK words.) For this system, 
you should allocate 3 swapping files. SWAPO.SYS, on a fixed head disk, 
should be large enough to hold the highly interactive jobs. SWAPS. SYS, also 
on a fixed head disk, should be able to hold the event-driven jobs. 
SWAP. SYS, on the moving head system disk, can accommodate all jobs. 

If your system has more than one moving head disk and no fixed head disk 
space is available for swapping files, you need to consider one more possibili- 
ty. If you are certain that two disks will always be mounted, you can create 
one swap file on each of two disks instead of creating one larger file on only 
one disk. Make the two files equal in size. This arrangement reduces access 
time for moving head disks because it uses the overlapped seek drivers effi- 
ciently. If, however, one of the disk drives becomes unavailable for use during 
time sharing, the system limits the maximum number of jobs that can log in. 
RSTS/E logs in only as many jobs as the existing swapping files can accom- 
modate. You can run the system with a reduced job maximum, or you can try 
to allocate additional swapping space on another disk. 

Now, consider the question of size. A swapping file must be (4 times SWAP 
MAX) blocks long to hold one job of size SWAP MAX. Thus, the total swap- 
ping space required on a system is (JOB MAX multiplied by 4 times SWAP 
MAX). Each swapping file holds an integral number of jobs, N, where 

N = Size of swapping file in blocks (truncated) 
SWAP MAX * 4 

Once you have decided how many jobs a particular swapping file needs to 
accommodate (N), simply calculate (N multiplied by SWAP MAX times 4) to 
determine the necessary size for each swapping file you plan to allocate. You 
can type the expression directly to REFRESH if you wish. For example, 
10*28K, 10*28*4, and 1120 all indicate enough space for 10 jobs if the 
SWAPMAX is 28K. Appendix B contains a table of disk device sizes, which 
you may find useful in determining swapping file sizes. 
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3.8.1 .2 Planning Optional System Files — To set up your system for optimal 
performance, you need to consider creation and placement of the additional 
contiguous system files BUFF.SYS, OVR.SYS, and ERR.SYS. If your system 
is configured for DECtape, you must create the file BUFF.SYS, which con- 
tains the DECtape buffers. This file must reside on the system disk and must 
contain at least three blocks for each DECtape unit on the system. If your 
system disk is a moving head device, you can group BUFF.SYS with other 
system files near the center of the occupied space on the disk for optimal 
performance. If your system disk is a fixed head disk, there is no need to 
specially place BUFF.SYS. 

OVR.SYS contains a copy of the monitor code (from the monitor SIL) which 
is not permanently resident. ERR.SYS contains a copy of the system error 
message file. Placing these two files on a disk with faster access time than that 
of your system disk will reduce the time to load these files when necessary. 

The files OVR.SYS and ERR.SYS perform no useful purpose on a fixed head 
system disk. Since the error messages and overlay code already reside on the 
fixed head system disk, placing them in separate files on the same fixed head 
disk does not improve performance and wastes disk space. 

If your system disk is a moving head disk and the system hardware configura- 
tion in'^ludes a fixed head disk, you can improve system performance by 
creating separate files to hold the overlay code and error messages during time 
sharing. REFRESH allows you to create and position the files OVR.SYS and 
ERR.SYS for this code. You gain optimal system performance by placing 
these two files, on a fixed head disk. Placing OVR.SYS and ERR.SYS on a 
fixed head disk should take precedence over allocating one extra swapping 
space in a swapping file. You can enable the use of these files by using the 
UTILTY program or the INIT.BAC system program (see the RSTS/E System 
Manager's Guide for a description of these programs). 

If space is not available on an auxiliary fixed head disk, group the files with 
other system files near the center of the occupied space on the system disk. 
This grouping can increase system performance by reducing average seek time 
for the disk heads. 



3.8.1.3 Planning for the Crash Dump File — The final system file you need to 
plan is CRASH. SYS. First, decide whether to create it; second, determine its 
optimal size. 

CRASH. SYS is optional, but, if included, must reside on the system disk. If 
you plan to enable the crash dump facility, you must create CRASH. SYS. 

To ensure that you do not lose error information if the system crashes, 
DIGITAL recommends that you create CRASH. SYS and enable crash dumps. 
The following are the steps RSTS/E takes when a crash occurs. 

1., The RSTS/E error handling code discovers an error from which it cannot 
recover. 
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2. RSTS/E dumps the contents of the read/write area of monitor memory 
into CRASH. SYS (if the file exists and the crash dump faciHty is 
enabled) . Since the dump preserves the state of the system at the time of 
the crash, it contains essential diagnostic information. 

3. RSTS/E then reboots the system disk and performs an auto-restart. 

For example, assume that monitor error logging routines log a parity error 
within monitor memory. The system crashes because the monitor may be 
corrupt. Since the ERRCPY program cannot run to log the error, the error 
data (and probably the cause of the crash) are lost unless a crash dump is 
performed. Creating CRASH. SYS and enabling the crash dump facility pre- 
vent this loss of error data. 

Allocate enough space to CRASH. SYS so that it can hold the read/write area 
of the RSTS/E Monitor. The read/write area of the monitor contains tables 
and data areas that change during time sharing. The size of the monitor 
read/write area depends on the system's hardware and software configuration, 
so it varies from system to system. It is usually 8K to 16K words (32 to 64 
blocks). 

To determine the size necessary for CRASH. SYS, examine the file status 
table printed by the LIST suboption. (See Section 3.8.3.) If your system disk 
is large, you can create CRASH. SYS at the maximum possible size (80 
blocks). Allocating an 80 block CRASH. SYS file allows for future expansion 
and reserves additional contiguous disk space. Contiguous space may not be 
available after the disk has been heavily used. If your system disk is too small 
to allow you to allocate an 80 block CRASH. SYS file, try to allocate a file 
approximately eight to twelve blocks larger than the minimum required size. 
An extra eight to twelve blocks provides space for 2K to 3K monitor expan- 
sion. Of course, if you are certain that your system disk will not be used for an 
expanded monitor, you need not configure any extra space at all. 

3.8.2 Using the REFRESH Option 

To invoke REFRESH, type REFRESH or RE in response to the OPTION: 
prompt. The option responds by requesting date and time. After you specify 
the date and time, REFRESH asks you for the disk type and unit on which to 
allocate the files. Type a disk name or press LINE FEED to specify the 
system disk. If you do not press LINE FEED, the REFRESH option requests 
the unit number of the disk. After you specify the disk to use, REFRESH may 
ask whether to clean the disk. Table 3-12 summarizes these questions and the 
possible responses. 

The cleaning operation, which repairs a corrupt file structure, performs the 
following steps: 

1. It builds a new storage allocation table (S ATT. SYS) that reflects all the 
files on the disk. 
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2. It scans all directories and deletes all files that have the extension .TMP 
or are marked for deletion. 

3. It finds any doubly-allocated blocks and allows you to specify their correct 
allocation. 

4. It finds and deletes all invalid directories. 

5. It marks the disk as having a clean file structure. 

6. It allows you to delete files that contain bad blocks. 

7. It writes zeroes over any disk blocks that were allocated before cleaning 
began but are no longer allocated. 



Table 3-12: REFRESH Questions and Responses 



Question 



DD-MMM-YY? 

HH:MM? 

DISK? 

UNIT? 

CLEAN? 



Response 



Type the date in alphabetic or numeric format, or press LINE FEED to 
accept the date printed. 

Type the time in 24-hour or AM/PM format, as in 15:12 or 3:12 PM. 
Press LINE FEED to accept the time printed. 

Type the name of the disk on which to allocate files. Valid disk names 
are DF, DS, DK, DL, DM, DP, DR, and DB. Press LINE FEED to use 
the system disk. 

Type the physical unit number of the disk. This question is not asked if 
the response to the previous question was DF, or LINE FEIED. 

Type YES to clean the disk. Type NO or press LINE FEED if you are 
certain that the directory structure of the disk is not corrupt. This 
question is asked only if the disk was logically dismounted after its last 
use. If the disk was not logically dismounted, the REFRESH option 
automatically cleans the disk. 



REFRESH automatically cleans a disk that was improperly removed from the 
system or, in other words, was not logically dismounted. If your disk was 
properly dismounted, REFRESH asks the CLEAN question. Specify a clean- 
ing operation if you suspect that the disk has a corrupt file structure. Any 
?BAD DIRECTORY FOR DEVICE errors occurring on a particular disk may 
indicate a corrupt file structure on that disk. You should also specify a clean- 
ing operation if a file containing a bad block was deleted during time sharing. 
The cleaning operation frees the portion of the file that did not contain any 
bad blocks. The amount of time required for the clean operation depends on 
the type of disk and the number of files it contains. 

After all preliminary questions have been asked and answered, you can 
begin to use the REFRESH suboptions to allocate files. Table 3-13 lists the 
suboptions. 
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Table 3-13: REFRESH Suboptions 



Suboption 



LIST 
CHANGE 
FILE 
BADS 



Function 



Lists the file status table. 
Changes the system file allocation. 
Changes the characteristics of a file in [0,1]. 
Examines or adds to the bad block file. 



To use a suboption, type the first two or more characters of its name in 
response to the REFRESH SUBOPTION question. REFRESH executes 
the suboption dialogue, makes any requested changes, and returns to the 
REFRESH SUBOPTION question. You can then specify another suboption 
or type CTRL/Z to return to the DISK question. When you are finished with 
the REFRESH option, type EXIT or press LINE FEED to return to the 
OPTION: question. 

3.8.3 Listing the Fiie Status Tabie 

The LIST suboption Hsts the file status table. This table includes all the files 
that may be in account [0,1] on the system disk. The files are divided into two 
categories: (1) the system files (under the heading System Files:) that you can 
manipulate with the REFRESH option and (2) other files (under the heading 
Others:). If you need a listing of only the files in the Others: category, type 
CTRL/0 during the printing of the system files. The output automatically 
resumes printing at the Others: header. The following is a sample file status 
table: 



REFRESH suboption? LIST 



File 
Name 

System files 



Required? 



File 
Fl a35 



C u r r e n t 
Status Size 



SWAP 

SWAPO 

SWAPl 

SWAPS 

OMR 

ERR 

BUFF 

CRASH 



SYS 
SYS 
SYS 
SYS 
SYS 
SYS 
SYS 
, SYS 



YES 
NO 
NO 
NO 
NO 
NO 

YES 
NO 



NOD CTG 



NOD CTG 



OK 
OK 
OK 
OK 
OK 
OK 
CRE 
OK 



224 



35 



Mini m u m 
Size 



BS 



43 

IB 

B 

35 



Start 
LBN 



132 



235B 



Others: 

BADB 

SATT 

INIT 

RSTS 

RTll 

BASIC 

ERR 



SYS 
SYS 
SYS 
SIL 
RTS 
,RTS 
, ERR 



NOD 
NOD CTG 

NOD 
NOD CTG 

CTG 
NOD CTG 
NOD CTG 



19 

:i4 

20 
B8 
IB 



452 
472 
218 



REFRESH suboption? 
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NOTE 

The file status table lists only files in account [0,11. Remember 
that the availability of space on the disk depends not only on 
the sizes of the files in account [0,1], but also in other accounts 
on the disk. 

The file status table is divided into seven columns, which are labelled File 
Name, Required?, File Flags, Status, Current Size, Minimum Size, and Start 
LBN. Table 3-14 summarizes the file status table entries. 

The File Name column lists all the files in account [0,1] by name. 

The entry in the Required? column indicates whether the file is required for 
operation of the currently installed RSTS/E Monitor. This column is blank for 
nonsystem files in [0,1] (i.e., files listed under the Others: heading). The file 
SWAP. SYS is always required on the system disk. The file BUFF. SYS is 
required on the system disk if the installed monitor supports DECtape. All 
other system files are optional on the system disk. All files are optional on a 
nonsystem disk. 

Table 3-14: File Status Table Entries 



Entry Heading 



File Name 



Required 



File Flags 



Status 



Current Size 



Possible Entries and Meaning 



All files in account [0,1] 

Files are divided into two categories under the headings System Files: 

and Others:, 

YES 

The file is required for operation of the current monitor. 

NO 

The file is not needed to operate the system, 

(blank) 

The file is not a system file, 

NOD 

The file cannot be deleted, 

CTG 

The file is contiguous on the disk. 

OK 

No REFRESH action is required, 

CRE 

You must create the file. 

D/C 

You must delete and re-create the file. 



The value n is the decimal number of 256-word blocks the file occupies 
on the disk. 

(blank) 

The file does not exist. 



(continued on next page) 
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Table 3-14: File Status Table Entries (Cont.) 



Entry Heading 



Possible Entries and Meaning 



Minimum Size 



Start LBN 



The value n is the decimal number of 256-word blocks the file minimally 
requires. 

n 

The value n is the logical block number (in decimal) at which each 
contiguous file starts. Disk logical blocks are numbered from to (disk 
size - 1). 

(blank) 

If the CTG flag is not present, the file is not contiguous. If the CTG flag 
is present, the file is currently contiguous but might be eligible to be 
extended, becoming noncontiguous. 



The File Flags column can contain the entries NOD and CTG. The entry 
NOD for a file means that even privileged users cannot delete that file during 
time sharing; the file can be deleted only during the use of the REFRESH 
option. The entry CTG means that the file is contiguous. 

The Status column (which is always blank for files in the Others: category) 
contains the entry OK, CRE, or D/C. The entry OK means that you need 
not use REFRESH on the file. The entry CRE means that you must use 
REFRESH to create the file. The entry D/C means that you must delete the 
file and re-create it. 

The Current Size column lists the current size of each existing file. If the file 
does not exist on the disk that is being REFRESHed, this column remains 
blank. 

The Minimum Size column (which is blank for all files in the Others: catego- 
ry) lists the minimum size (in blocks) for each file if RSTS/E is to use that 
file. The minimum size for SWAP. SYS is four times the current value of 
SWAP MAX multiplied by two (to hold two jobs). If you have not yet set 
defaults for the installed monitor, the minimum size is 64 blocks - 2 jobs at 
8K words each. ERR.SYS must always be sixteen blocks long. The minimum 
sizes of OVR.SYS and CRASH.SYS depend on the installed RSTS/E 
Monitor. BUFF.SYS must contain at least three blocks for each DECtape 
unit that the installed monitor supports. The Minimum Size column is blank 
for OVR.SYS, CRASH.SYS, and BUFF.SYS if no monitor is currently 
installed. The column is blank for SWAP.SYS, CRASH.SYS, and BUFF.SYS 
if you are not REFRESHing the system disk because RSTS/E can use these 
files only on the system disk. 

The column labelled Start LBN lists the logical block number (in decimal) at 
which each of the contiguous files starts. If a file does not exist or is not 
marked as contiguous, its entry in the Start LBN column is blank. 
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3.8.4 Changing System File Allocation 

The CHANGE suboption allows you to create, delete, and relocate contiguous 
files on disk. Since CHANGE creates and relocates files by simply manipulating 
the directory structure, you should not use it on files that contain data (such 
as ERR.ERR). CHANGE does not copy files; it merely allocates them in 
directories. 

CHANGE begins by asking questions about each of the files it can manipu- 
late. When the dialogue is complete, CHANGE performs the specified file 
operations and returns to the REFRESH SUBOPTION question. To exit from 
the suboption before answering all questions, type CTRL/C. This causes all 
changes to be aborted. Table 3-15 summarizes the CHANGE questions and 
possible responses. 



Table 3-15: CHANGE Suboption Questions and Responses 



Question 



Possible Responses and Meaning 



f i 1 n a m » e X t 
CHANGES? 



OTHER FILES' 



DELETE' 



SIZE' 



NO, OLD, LINE FEED key 

If the file exists, accept its current size and location and skip the re- 
maining questions for this file. 

YES 

If the file exists, skip to the DELETE question. If the file does not exist, 

skip to the SIZE question. 

CTRL/Z 

Return to the REFRESH SUBOPTION question. 

NO, N, LINE FEED key, CTRL/Z 

Last question in the CHANGE suboption. Returns to the REFRESH 

SUBOPTION question. 

filnam.ext 

Allows you to create or delete other [0,1] files. This capability is 
intended primarily for DIGITAL software support personnel. Certain 
system files in [0,1] (such as INIT.SYS) must never be modified. If the 
named file exists, skip to the DELETE question. If the file does not 
exist, skip to the SIZE question. 

NO, OLD, LINE FEED key 

Asked only if the file exists. Skip to the SIZE question. 

YES 

Delete the file and skip the remaining questions for this file. 

CTRL/Z 

Return to the first question for this file. 

OLD, LINE FEED key 

If the file exists, retain the current size. If REFRESH is creating the 
file, create it at the minimum size. 



The value n, a positive nonzero integer, is the decimal number of blocks 
allocated to the file. 



(continued on next page) 
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Table 3-15: CHANGE Suboption Questions and Responses (Cont.) 



Question 


Possible Responses and Meaning 


SIZE? 
(cont.) 

BASE? 


p * qK 

If the JOB MAX'"is p and the SWAP MAX is q, then the number of 
blocks allocated to the file is p * qK. When you type the letter K, the 
initialization code is in affect multiplying the p * q product by 4 blocks, 
or IK words. This procedure converts the file size from K words to 
blocks. Therefore, type the number of jobs p, the asterisk which indi- 
cates multiplication, the SWAP MAX q, the letter K, then press 
RETURN to instruct the initialization code to calculate the file size in 
blocks. 

CTRL/Z 

Return to the filnam.ext CHANGES question for this file (or to the 

OTHER FILES question if the current file is not a system file). 

OLD, LINE FEED key 

For an existing file, type OLD or press LINE FEED to retain the file at 
its current starting location, or the next available space if unable to 
place it at its current location. When creating a new file, type OLD or 
press LINE FEED to place the file at the first available space on the 
disk (same as typing 0). 

n 

The value n is a decimal number that specifies the starting logical 
block number for the file. Type to place the file at the first available 
space on the disk. 

CTRL/Z 

Return to the first question for this file. 



CHANGE can alter characteristics of the files SWAP.SYS, SWAPO.SYS, 
SWAPl.SYS, SWAP3.SYS, OVR.SYS, ERR.SYS, BUFF.SYS, and 
CRASH. SYS. It also allows you to create or delete other files (with the 
OTHER FILES question) in account [0,1]. The suboption asks all of the 
questions in Table 3-15 for each file in the above list, substituting the name of 
the file for filnam.ext in the question. The following is an example of 
CHANGE: 

a REFRESH suboption? CH 

b SWAP.SYS changes? Y 
c Size? 2*28K 
d Base? (EF) 

e SWAPO.SYS changes? (lf) 

f SWA PI .SYS changes? © 

g SWAP3.SYS changes? (lf) 

h OVR.SYS changes? © 

i ERR.SYS changes? (lf) 
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j 


BUFF, SYS changes? Y 


k 


Size? 12 


1 


Base? © 


m 


CRASH. SYS changes? Y 


n 


Size? 80 





Base? © 


P 


Other files? © 


q 


REFRESH sub option? 



The letters that prefix the explanations that follow are keyed to identifying 
letters located within the previous DSKINT example. Follow the lettered 
steps through this sequence of steps: 

a. Specify the CHANGE option, then terminate your response by pressing 
RETURN. 

b. Indicate that you want to change the size of SWAP. SYS by typing Y. 

c. Let the initialization code calculate the 224 block size by entering the 
formula, 2 * 28K. The K is interpreted to equal 4 blocks. SWAP. SYS can 
hold 2 jobs at a maximum size of 28K words. 

d. Press LINE FEED to place SWAP. SYS at the first available space on the 
disk. 

e. Press LINE FEED to make no changes to the files SWAPO.SYS, 
SWAPLSYS, SWAP3.SYS, OVR.SYS, and ERR.SYS. 

f. Indicate that you want to make a change to the space allocated for 
BUFF.SYS by typing Y. 

g. Give BUFF.SYS 12 blocks for 3 DECtape drives. 

h. Create CRASH.SYS at a maximum size of 80 blocks (1 * 20K). 

i. Press LINE FEED to omit changes to any other files. 

j. Note that you return to the REFRESH suboption prompt. 

3.8.5 Changing [0,1] File Characteristics 

The FILE suboption allows you to create, delete, or mark as deletable or not 
deletable files in account [0,1]. It is intended mainly for two uses: 1) deleting 
obsolete run-time system files, and 2) marking other files as deletable or not 
deletable. 

When you invoke the FILE suboption, REFRESH responds by asking you for 
the name of the file to modify. Reply with a filename and extension. If the file 
exists in account [0,1], REFRESH asks whether you want to delete it. Type 
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YES or NO in response. If your response is NO, REFRESH retains the file. It 
then asks SIZE and BASE questions as in the CHANGE suboption. Refer to 
Table 3-15 for a summary of responses to these questions. 

NOTE 

INIT.SYS, the default error message file (e.g., ERR.ERR), the 
installed monitor SIL, and the default run-time system file can 
never be modified on the booted disk. 

REFRESH allows you to change the status of the "do not delete" bit in the 
directory entry for the named file. When this bit is on, users cannot delete or 
rename the file under RSTS/E time sharing. The bit is automatically turned 
on when you set defaults (for the default error message and run-time system 
files), when you install the monitor SIL, and when you create other system 
files. When the bit is off, any privileged user can delete the file. To turn off the 
bit, type YES in response to the DELETABLE question. To turn on the bit, 
type NO. To retain the current status of the bit, type OLD or press LINE 
FEED. 

The capability to set and reset this bit can be useful in many circumstances. 
For example, if your system has important accounting files that you want to 
protect from deletion, you can simply use the PIP program during time shar- 
ing to transfer the files to account [0,1], bring the system down, and use the 
REFRESH option to set the "do not delete" bit as in the example below. This 
bit protects the files so that they cannot be deleted during time sharing. Files 
for which the "do not delete" bit is set can, however, be extended. Only 
another use of the REFRESH option can delete them. The following example 
shows the use of the FILE suboption to set the "do not delete" bit for the file 
MASTER.DAT. 

REFRESH suboption? FILE 

File name? MASTER.DAT 

File exists. Delete it? M 

Size? (2) 

Base? © 

Deletable?N 

F i 1 e n a (ii e ? (Cg 
REFRESH suboption? 

Be careful to specify OLD or LINE FEED in response to the SIZE and BASE 
questions if you wish to retain the data in the files. The REFRESH option 
manipulates directory information only; it does not transfer actual file data. 
Therefore, if you do not reply to these questions with OLD or LINE FEED, 
REFRESH may reallocate the file and the data may be lost. 
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3.8.6 Expanding the Bad Block File 

The BADS suboption enables you to list the bad blocks currently in the bad 
block file for the disk currently being REFRESHed and to add bad blocks to 
the file. 

To use BADS, type BADS, BAD, or BA. REFRESH responds with BADS?. 
Type LIST for a listing of the current contents of the file BADB.SYS. The list 
is in the following format: 

Bads? LIST 

Packcluster5ize=l 

Bad clusters b e sf i n at logical block numbers: 
3237 IX\11 
Bads? 

If the file contains no bad blocks, REFRESH responds as follows: 

Bads? LIST 

There are no bad blocks* 
.Bads? 

After the listing or message is complete, REFRESH returns to the BADS 
question. Type ADD to add bad blocks to the file. REFRESH responds with 
BLOCK NUMBER?. Reply with the logical block number (in decimal) of the 
bad block. This number can be from 1 to the disk size minus 1. You can 
obtain the logical block number of a bad block from the ERRDIS printout of 
the disk error. REFRESH questions you to ensure that you have typed the 
correct number. Reply with YES or NO. If your response is YES, REFRESH 
allocates the pack cluster in which the block resides to BADB.SYS. If you 
reply NO, REFRESH repeats the BLOCK NUMBER prompt. Be careful to 
specify the correct block number. The allocation of a cluster to BADB.SYS is 
irrevocable. 

After you have added all bad blocks to the file, type EXIT or press LINE 
FEED to return to the REFRESH SUBOPTION question. If you added any 
bad blocks to the bad block file, REFRESH now cleans the disk. The cleaning 
operation allows you to delete all files that contain bad blocks. 

The following example illustrates the use of BADS: 

REFRESH suboption? BADS 
Bads? ADD 

Block n u (ri b e r ? 21 2 

Really add logical block 2102 to BADB.SYS? y 
Block number? rm 
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Bads? LIST 

PacK cluster size = 1 

Bad clusters be^in at logical blocK nufribers 
3237 4177 2102 

Bads? (Lf) 
D i s K is b e i n j^ cleaned - wait « « « 



REFRESH suboption? 

3.8.7 REFRESH Option Examples 

Two examples of the use of the REFRESH option follow. In the first example, 
the system files are structured to allow future expansion. The second example 
is a small system where disk space is of primary importance. On this system, a 
reasonable structure of system files is created but no provision is made for 
future expansion. 

3.8.7.1 RP04 System Disk with RS04 Disic — The first example shows a system 
file allocation typical for a large system disk. The hardware configuration 
includes an RP04 system disk and an auxiliary RS04 fixed head disk. Four 
DECtapes are also included in the system. The system is configured for a 
maximum of 40 jobs at a maximum size of 28K words each. The listing of this 
example follows. 

Option: REFRESH 

10-MAY-79?.(LF) 
0-a:50? © 

a DisK? DS 

Unit? 
b Clean? Y 

DisK is b e i n jS cleaned - wait . . » 
c REFRESH sub option? LIST 



n i (T) u fi) Start 
Size LBN 



File 






F 


ile 




C u r r e n t 


Name 


R 


e =1 u i r e 


d ? F 1 a d s 


Status 


Size 


System f 


i 1 e s : 












SWAP 


.SYS 


NO 






OK 




SWAPO 


,SYS 


NO 






OK 




SWAPl 


.SYS 


NO 






OK 




SWAP3 


.SYS 


NO 






OK 




OUR 


.SYS 


NO 






OK 




ERR 


.SYS 


NO 






OK 




BUFF 


.SYS 


NO 






OK 




CRASH 


.SYS 


NO 






OK 




Others : 














BADB 


.SYS 






NOD 







SATT 


.SYS 




NOD 


CTG 




1 



43 
IS 
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d REFRESH suboption? BADS 
Bads? LIST 

There are no bad b 1 o c K s . 
Bads? EXIT 
e REFRESH suboption? CHANGE 

SWAP. SYS changes? (lf) 
f SWA PO. SYS changes? Y 
g Size? 17*28K 
Base? ® 
SWA PI »SYS changes? © 
SWA P3, SYS changes? © 
h OMR.SYS changes? Y 
Size? B^ 
Base? © 
i ERR. SYS changes? Y 
Size? IB 
Base? © 
BUFF. SYS changes? © 
CRASH. SYS changes? © 
Other f i les? © 
j REFRESH suboption? '• Z 
k DisK? © 
1 Clean? N 
m REFRESH suboption? LIST 



File 
Name 



File Current Minim um Start 

Required? Fla^s Status Size Size LBN 



System files 



SWAP 


.SYS 


YES 


SWAPO 


.SYS 


NO 


SWAPl 


.SYS 


NO 


SWAP3 


.SYS 


NO 


OMR 


.SYS 


NO 


ERR 


.SYS 


NO 


BUFF 


.SYS 


YES 


CRASH 


.SYS 


NO 



CRE 
OK 
OK 
OK 
OK 
OK 

CRE 
OK 



190a 



72a 



sa 

IB 
12 
34 



1 
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Others : 

BADB .SYS 
SATT .SYS 
INIT .SYS 
SYSGEN .SIL CTG 185 240 





NOD 


NOD 


CTG 


NOD 


CTG 




CTG 


NOD 


CTG 




NOD 


NOD 


CTG 








11 


12 


419 


28 




185 


20 


428 


IG 


448 


205 





RTll .RTS 

ERR .ERR 

RSTS .SIL 

BASIC .RTS NOD CTG 72 4520 



n REFRESH suboption? CHANGE 

o SWAP. SYS changes? y 

Size? 23#28K 

Base? goo o 
SWA PO. SYS chancres? (lf) 
SWAPl.SYS changes? (LF) 
SWAPS. SYS changes? (lf) 
C'R.SYS changes? @ 
ERR, SYS chansfes? (lf) 

p BUFF. SYS changes? y 
Size? 12 
Base? 80000 

q CRASH. SYS chansfes? y 
Size? BO 
Base? @ 
Other f i les? (g) 

r REFRESH suboption? LIST 

File File Current Minimum Start 

Name Required? Fla^s Status Size Size LBN 

System files: 

257B 224 80000 



G4 

18 
12 12 82578 

80 34 892 



SWAP 


.SYS 


YES 


NOD 


CTG 


OK 


SWAPO 


.SYS 


NO 






OK 


SWAPl 


.SYS 


NO 






OK 


SWAPS 


.SYS 


NO 






OK 


01,'R 


.SYS 


NO 






OK 


ERR 


.SYS 


NO 






OK 


BUFF 


,SYS 


YES 


NOD 


CTG 


OK 


CRASH 


.SYS 


NO 


NOD 


CTG 


OK 
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Others: 




BADB 


.SYS 


SATT 


♦ SYS 


INIT 


, SYS 


SYSGEN 


♦ SIL 


RTll 


. RTS 


ERR 


.ERR 


RSTS 


.SIL 





NOD 


NOD 


CTG 


NOD 


CTG 




CTG 




CTG 


NOD 


CTG 




NOD 


NOD 


CTG 





11 12 

209 28 

185 240 

20 428 

8 448 

205 

BASIC .RTS NOD CTG 72 4520 

s REFRESH sub option? EXIT 

Option: 

The letters that prefix the explanations that follow are keyed to identifying 
letters located within the previous D SKINT example. Follow the lettered 
steps through this sequence of steps: 

a. Answer the date and time question. The REFRESH option then requests 
the name of the disk on which it should manipulate files. Allocate files on 
the auxiliary fixed head disk. You already used the DSKINT option to 
perform pattern checking and to write a minimal RSTS/E file structure on 
this disk. Your response to the DISK question is DS, which is the device 
mnemonic of the RS04 disk. It is mounted on unit 0. 

b. Request the cleaning operation to ensure that the file structure on the disk 
is not corrupt. 

c. Use the LIST suboption to obtain a listing of the current File Status Table 
for the disk. 

d. Use the BADS suboption to list the bad block file. The message indicates 
that there are no bad blocks in the bad block file. Since there are no bad 
blocks, you type EXIT to return to the REFRESH SUBOPTION prompt. 

e. Request the CHANGE suboption which can create, delete, and position 
system files. You decide not to make any changes to SWAP. SYS. Pressing 
LINE FEED bypasses this question. 

f. Request a change to SWAPO.SYS by typing Y and pressing RETURN. 

g. Create the file SWAPO.SYS at a size of 1904 blocks which is 17 jobs 
multiplied by a swap maximum of 28K words. The letter K represents 4 
blocks per IK word. No changes are made to SWAPl.SYS and 
SWAP3.SYS. 

h. Create the file, OVR.SYS, to hold the overlay code. The size of OVR.SYS 
is 64 blocks which is the minimum size listed in the File Status Table. 

i. Create ERR. SYS at a size of 16 blocks, then press LINE FEED in response 
to the remaining questions. The REFRESH option automatically returns 
to the REFRESH SUBOPTION question. 

j. Type CTRL/Z to return to the DISK question to prepare for the allocation 
of files on the system disk. 
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k. Press LINE FEED in response to the DISK question to specify the system 
disk. 

1. Omit the cleaning operation because the disk was recently initialized. 

m. Specify the LIST suboption and begin to list the File Status Table for the 
system disk. 

n. Select the CHANGE suboption and begin to allocate system files on the 
system disk. 

o. Request changes to SWAP. SYS. Since the fixed head disk cannot accom- 
modate all the required swapping space, allocate additional space on the 
system disk. Create SWAP. SYS at 2576 blocks, which is large enough for 
23 jobs (40 minus the 17 covered by SWAPO.SYS) at 28K words each. This 
file provides the remaining swapping space that the system requires, so 
you need not create other swapping files. Note that you specify a preferred 
starting location of 80000 to place SWAP. SYS near the center of the 
167200 block disk. Grouping the frequently accessed system files near the 
center of the disk reduces average seek time for the disk heads. The effect 
of this grouping becomes more pronounced as your files and directories fill 
the disk. You do not create on the system disk the other swapping files of 
the overlay and error message files. 

p. Create the file BUFF. SYS that this system requires for its four DECtape 
drives. RSTS/E requires that BUFF.SYS contain at least three blocks for 
each DECtape unit. 

q. Allocate for the crash dump file, CRASH. SYS, a maximum of 80 blocks 
rather than the minimum of 34 blocks. The larger CRASH. SYS file per- 
mits further expansion and reserves extra contiguous space that may be 
needed later. You do not position CRASH. SYS file since it is not fre- 
quently used. 

r. Specify the LIST suboption to obtain a final listing of the File Status 
Table. REFRESH placed all files as requested. 

s. Exit from the REFRESH option and the initialization code returns to the 
OPTION: prompt. 

3.8.7.2 RL01 System Disk — The second example shows the use of the 
REFRESH option on a smaller system which includes two RLOl disks (one 
the system disk) and no fixed head disks. The hardware configuration also 
includes two DECtape units. The maximum number of jobs on this system is 
20, and their maximum size is 28K words. The example and its explanation 
follows. 

a Option: REFRESH 

b 03-Apr-79? © 
07:21 PM? © 

c DisK? © 

Clean? © 



3-66 Tailoring the SYSGEN System 



REFRESH s u b p t i n 



LIST 



File 
Name 

System files 



R e q u i red? 



File Current 

Flads Status Size 



SWAP 


.SYS 


YES 


NOD 


CTG 


OK 


102a 


SWAPO 


,SYS 


NO 






OK 




SWAPl 


.SYS 


NO 






OK 




SWAPS 


.SYS 


NO 






OK 




OMR 


.SYS 


NO 






OK 




ERR 


.SYS 


NO 






OK 




BUFF 


.SYS 


NO 


NOD 


CTG 


OK 


IB 


CRASH 


.SYS 


NO 


NOD 


CTG 


OK 


sa 


Others: 














BADE3 


.SYS 






NOD 







SATT 


.SYS 




NOD 


CTG 




1 


ERR 


.ERR 






CTG 




IB 


RSTS 


.SIL 






CTG 




^2U 


BASIC 


.RTS 






CTG 




72 


RTll 


.RTS 






CTG 




20 


RSK 


.RTS 






CTG 




15 


TECO 


.RTS 






CTG 




33 


INIT 


.SYS 




NOD 


CTG 




418 



Mini m u m 
Size 



ea 



IB 



Start 
LBN 



isai 



877 
813 



5105 

BBS 
737 
757 
773 



e REFRESH sub option? BADS 
Bads? LIST 
There are no bad b 1 c K s . 

f Bads? EXIT 

g REFRESH sub option? CHANGE 

h SWAP. SYS changes? y 
Delete? m 

i Size? B*28K 

j B a s e ? 5 1 1 

SWAPO. SYS ch anises? @ 
SWA PI. SYS chanses? © 
SWAP3.SYS changes? (lf) 
OUR. SYS changes? (tp) 
ERR. SYS ch anises? @ 
BUFF. SYS changes? (g) 
CRASH. SYS changes? ([g 
Other files? m 
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REFRESH suboption? LIST 

File File Current M i ri i m u m Start 

Name Required? Fla^s Status Size Size LBN 



System files: 



SWAP 


»SYS 


YES 


NOD 


CTG 


OK 


SWAPO 


♦ SYS 


NO 






OK 


SWAPl 


♦ SYS 


NO 






OK 


SWAPS 


♦ SYS 


NO 






OK 


OVR 


♦ SYS 


NO 






OK 


ERR 


♦ SYS 


NO 






OK 


BUFF 


♦ SYS 


NO 


NOD 


CTG 


OK 


CRASH 


♦ SYS 


NO 


NOD 


CTG 


OK 


Others: 












BADB 


♦ SYS 






NOD 




SATT 


♦ SYS 




NOD 


CTG 




ERR 


♦ ERR 






CTG 




RSTS 


♦ SIL 






CTG 




BASIC 


♦ RTS 






CTG 




RTll 


♦ RTS 






CTG 




RSX 


♦ RTS 






CTG 




TECO 


♦ RTS 






CTG 




INIT 


♦ SYS 




NOD 


CTG 





1 REFRESH suboption? '- 2 



m DisK? DL 
Unit? 1 



n Clean? Y 

DisK is b e i n d cleaned - wait ♦ ♦ ♦ 

o REFRESH suboption? CHANGE 
SWAP. SYS changes? 

p SWAPO .SYS changes? Y 

q Size? 14*28K 
Base? 5110 

r SWAPl ♦SYS changes? © 
SWAPS^SYS changes? © 
OUR. SYS changes? © 
ERR ♦SYS changes? © 
BUFF .SYS changes? © 
CRASH ♦SYS changes? © 
Other f i les? © 



672 G4 5233 



IB 
IS 877 

G4 813 



5105 
1 

IB 225 

aza 

72 BG5 

20 737 

15 757 

39 773 
418 
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REFRESH suboption? LIST 



File 






File 




C ij r r e n t 


Mini m u ti\ 


Start 


Name 


R 


e <=i u i r e d 


? F 1 a d 5 


Status 


Size 


Size 


LBN 


System f 


i 1 es : 














SWAP 


.SYS 


NO 




OK 








SWAPO 


.SYS 


NO 


NOD CTG 


OK 


1568 




5110 


SWAPl 


.SYS 


NO 




OK 








SWAPS 


.SYS 


NO 




OK 








OUR 


,SYS 


NO 




OK 








ERR 


.SYS 


NO 




OK 




IS 




BUFF 


.SYS 


NO 




OK 








CRASH 


.SYS 


NO 




OK 








Others: 
















BADB . 


,SYS 




NOD 











SATT . 


,SYS 




NOD CTG 




3 




9 


INIT . 


, SYS 




CTG 




418 




49 


t REFRESH suboption? 


EXIT 










Option: 

















The letters that prefix the explanations that follow are keyed to identifying 
letters located within the previous REFRESH example. Follow the lettered 
steps through this sequence of steps: 

a. Select the REFRESH option to list the system file status, change the 
system file allocations, and examine the bad block file. 

b. Respond to the date and time questions by pressing LINE FEED since 
both are correct. 

c. Press LINE FEED to indicate that the disk you want to specify is the 
system disk. 

d.. Specify the LIST suboption to obtain a listing of the File Status Table. 

e. Use the BADS suboption to list the bad block file. The THERE ARE NO 
BAD BLOCKS message indicates there are no bad blocks in the bad block 
file (BADB.SYS). 

f. Type EXIT to return to the REFRESH SUBOPTION, since you do not 
have any bad blocks to add to the bad block file. 

g. Specify the CHANGE suboption because you need to alter the SWAP.SYS 
file. 

h. Type Y to indicate you want to make changes to the SWAP.SYS file. 
RSTS/E requires that SWAP.SYS exist on the system disk at a size large 
enough to hold at least two jobs at the maximum size of 16K words. 
Allocate all swapping space in SWAP.SYS on the system disk or divide the 
swapping space between the two RLOl disks. Before you allocate swapping 
space on the second RLOl, you should be reasonably certain that the disk 
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will always be mounted. It can be either a public or private disk. If the 
second disk becomes unavailable for use during time sharing, the system 
runs with a reduced job maximum until the system manager can allocate 
additional swapping space for that time-sharing session. Since you are 
reasonably certain that the second RLOl disk will remain mounted, you 
allocate only a third of the necessary space to SWAP. SYS on the system 
disk. You will create another swapping file when you use the REFRESH 
option on the second disk. 

i. Specify a size of only 672 blocks (6 jobs at 28K words each) for the 
SWAP. SYS file on the system disk since it is more advantageous to locate 
the largest portion of the swapping space on the second RLOl disk. You 
will allocate more swapping space on the second disk. 

j. Place the file near the center of the 10220-block disk at block 5110. Locat- 
ing frequently used system files near a disk's center decreases the average 
seek time for the disk heads and improves system performance as file data 
becomes scattered across the disk. You do not create any other swapping 
files on the system disk. 

k. Use the LIST suboption again to check the file allocation figures. This is a 
useful step to perform after you have set up all files for the system disk. 

1. Type CTRL/Z in response to the REFRESH SUBOPTION prompt to re- 
turn to the DISK question. 

m. Type DL in response to the DISK question and 1 in response to the UNIT 
question. You have now specified the second RLOl disk. 

n. Request that REFRESH clean the disk to ensure that the file structure is 
not corrupt. 

o. Type CHANGE in response to the REFRESH SUBOPTION question so 
that you can create the additional swapping file. 

p. Choose SWAPO.SYS as the additional file because the system swaps 
highly interactive jobs (which have the fastest access time available) to the 
first swapping file it finds. Access to the second RLOl may be slightly 
faster than access to the system disk. The system normally makes fewer 
accesses to the second RLOl than to the system disk because it starts all 
searches on user directories on the system disk. Placing the burden of a 
frequently used swapping file on the second RLOl can help to even the load 
between the two disks. 

q. Create SWAPO.SYS at a size of 1572 blocks (14 jobs at 28K words each), 
and place the file at the center of the disk. 

r. Type LINE FEED to the remaining CHANGE questions. 

s. List the File Status Table once more to check the current sizes of your 
system files. 

t. Type EXIT to leave the REFRESH option and return to the OPTION: 
prompt. 
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3.8.8 REFRESH Dialogue Error Messages 

Table 3-16 summarizes the error messages that can appear during the 
REFRESH dialogue. 

Table 3-16: REFRESH Dialogue Error Messages 



Message and Meaning 



CANNOT REFRESH THIS DISK 
Rerun DSKINT, then try again. 

ILLEGAL DISK NAME 

The response you typed is not a valid disk name. Valid disk names are 
DF, DS, DK, DL, DM, DP, DR, and DB. Press LINE FEED to use the 
system disk. 

ILLEGAL SUBOPTION 

The response you typed was not a valid suboption name. 

SORRY » BUT THAT DISK DOESN'T EXIST 

The disk device or unit number you specified does not exist on this 
PDP-11. Use the HARDWR option to list the hardware configuration. 

THAT FILE CANNOT BE CHANGED 
You cannot modify the file. 

TOO MANY BAD BLOCKS 

There cannot be more than 161 clusters in the bad block file. 

UNABLE TO CREATE REQUESTED FILE(S) 

The disk does not contain sufficient contiguous space at the specified 
bases to create the specified files. Try again, specifying different bases 
or smaller files. 



The preceding table explains only the error messages that can appear during 
the dialogue portions of REFRESH. For information on processing errors, 
refer to Appendix A. 



3.9 Setting System Defaults 



The RSTS/E initialization code includes routines that allow you to establish 
system default start-up conditions. These defaults include the following: 

1. the maximum number of jobs the system allows during time sharing and 
the maximum storage space a job can occupy in memory and in the 
swapping files. 

2. the run-time system and error message files. 

3. the installation's name, which is used in LOGIN'S identifying message. 

4. the allocation of certain portions of memory. 
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5. the data caching parameters. 

6. the allocation of UNIBUS mapping registers. 

7. the state of the crash dump facility, 

8. the labelling format for magnetic tapes. 

9. the system clock you will use to generate a system time base. 

10. the formats for date and time. 

11. the power fail delay for your system. 

You must set the defaults after you create the system files and before you 
start time sharing. You can override some of the default conditions (job and 
swap maxima, all memory allocations, and crash dump) when you start time 
sharing. Any changes that you make at start-up time are temporary. They 
apply to the current time-sharing sessions (and any auto-restart after a sys- 
tem crash) . After this time-sharing session, the permanent defaults are again 
in effect. 

Note that defaults are set for a particular monitor rather than for a particular 
system device. Therefore, you must set defaults whenever you install a moni- 
tor for the first time. 

Use the DEFAULT option and its suboptions to set defaults. To invoke the 
DEFAULT option, type DEFAULT or DE in response to the OPTION: 
prompt. If you have not yet installed a SIL, DEFAULT prints the following 
message and returns to the OPTION: prompt. 

DEFAULTS CANNOT BE SET UNTIL A SiL IS INSTALLED 

Use the INSTALL option to install a SIL. Refer to Section 3.7 for a discussion 
of the INSTALL option. 

If you have installed a SIL, but have not yet used the DEFAULT option, 
DEFAULT disables the responses OLD and LINE FEED to all questions and 
prints: 

NO DEFAULTS ARE CURRENTLY SET 

DEFAULT then prompts you for the information needed to set the defaults 
described in the following sections. 



3.9.1 Setting Job and Swap Maximums 

The first defaults that you set are job and swap maxima. The job maximum is 
the largest number of jobs that can run during RSTS/E time sharing. The 
default job maximum (set with the DEFAULT option) can be any value from 
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1 to the configured job maximum which is the Hmit you set when you an- 
swered the configuration questions. The configured job maximum for the 
SYSGEN system (which DIGITAL sets) is two. 

The swap maximum is the maximum amount of storage space that the largest 
allowed job can occupy in a swapping file. Since all jobs must be swappable, 
the swap maximum is also the largest size in memory to which each job can 
expand. 

The maximum number of jobs and the maximum size to which a job can 
expand affect the sizes of the swapping files. A swapping file must be at least 
(SWAP MAX times 4) blocks long to hold one job of size SWAP MAX. Note 
that SWAP MAX is measured in memory storage units (K, where IK = 1024 
words), whereas file length is measured in disk storage units (blocks, where 1 
block = 256 words). Four blocks equal IK words. Thus, each swap file holds an 
integral number of jobs, N. You can compute N by using the following equa- 
tion and truncating the result to an integral value. 

Size of swap file in blocks 

^ " SWAP MAX*4 



The total number of jobs that all swap files can accommodate limits the 
number of jobs that can log in. The one required swap file, SWAP. SYS, must 
be large enough to accommodate at least two jobs of size (SWAP MAX times 
4) blocks. You can add up to three more swap files by using UTILTY com- 
mands in the control file at system start up. When you enable logins after 
adding a swap file to the system, the maximum number of jobs that can log in 
increases by the number of jobs the new swap file can accommodate. The 
maximum number of jobs that can login cannot be greater than the default 
job maximum. If the value (2 multiplied by SWAP MAX times 4) is greater 
than the current size of the file SWAP.SYS, DEFAULT prints the following 
message: 



Warning - this SWAP MAX requires that SWAP ♦SYS be at least n 
b 1 c K 5 . SWAP.SYS is currently m b 1 o c K s ♦ 

In the message, n is the number of blocks required to hold 2 jobs at size SWAP 
MAX, and m is the current size of the file SWAP.SYS. 

For the SYSGEN system, set the job maximum at 2 and the swap maximum 
at 28K words. For the Target system, you should select values for job and 
swap maxima that. are compatible with your software. For example, although 
the initialization code allows a value for SWAP MAX between 8K and 31K 
words, the BASIC-PLUS Run-Time System does not permit any of its jobs to 
exceed ,16K. The RSTS/E COBOL Compiler requires a 28K word swap maxi- 
mum. FORTRAN IV requires a swap maximum of at least 8K words, but can 
use up to 28K words. 
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At start-up time and during the DEFAULT option, the initiahzation code 
prints the current values for job and swap maxima. It then requests any 
changes, as in the example that follows: 

Option: DEFAULT 

No defaults are currently set 

You currently haue: JOB MAX = 2» SNAP MAX = 1GK» 

JOB MAM or SWAP MAX changes? YES 

New JOB MAX? © 

New SWAP MAX? 28 
You currently haue: JOB MAX = 2» SWAP MAX = 28K . 
JOB MAX or SWAP MAX changes? 

When you first use the DEFAULT option on a monitor SIL, the option prints 
the configured job maximum and a swap maximum of 16K words. DEFAULT 
then asks the JOB MAX OR SWAP MAX CHANGES question. Answer by 
typing NO or pressing LINE FEED to retain the printed values for job and 
swap maxima and proceed to establish default files. Answer YES to change 
one or both of the values. If your answer is YES, the DEFAULT option prints 
the NEW JOB MAX question. Respond with a decimal number between 1 
and the configured job maximum, inclusive, to change the value or with NO, 
OLD, or the LINE FEED key to retain the current value. The next question is 
NEW SWAP MAX Your answer can be any integer between 8 and 31, or NO, 
OLD or the LINE FEED key as in the previous question. When you have 
answered both questions, DEFAULT prints the JOB MAX and SWAP MAX 
value and once again allows you to change them. Respond as in the first 
question. When the values are correctly set, DEFAULT proceeds to questions 
about default files. 

3.9.2 Establishing Defauit Files 

After setting up default job and swap maxima, you must designate the default 
run-time system and error message files for use during time sharing. The 
default run-time system for most installations is BASIC-PLUS. The default 
run-time system file must be a contiguous file on the system disk in account 
[0,1], be a keyboard monitor, and have the extension .RTS. The default error 
message file also must be in account [0,1]. It must be exactly 16 blocks long, 
and have the extension .ERR. Both the error message file and the default run- 
time system file must be contiguous. 

DEFAULT prompts you first for the name of the default run- time system file. 
If you already installed a run-time system as the default, its name appears in 
the prompt. For the SYSGEN system, you must type RTll. For the Target 
system, type the name (one to six alphanumeric characters) of the run-time 
system you desire as the default. The BASIC-PLUS Run-Time System that 
you can generate with the RSTS/E Monitor has the name BASIC unless you 
specify a different name during the configuration questions. To retain the 
currently installed run-time system, press LINE FEED in response to the 
prompt. 
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Next, DEFAULT asks you to specify the default error message file. If you 
have already installed an error message file, the prompt includes its name. 
Press LINE FEED to retain the current default file or type the name (one to 
six alphanumeric characters) of the error message file you prefer to install as 
the default. Press RETURN to either of the questions that follow to get a list 
of all legal responses. The following is an example of establishing default files 
for the SYSGEN system. 

R u n Time System? R T 1 1 
Elrror message file? ERR 

DEFAULT routines ensure that each file you specify is in the correct format. 
The routines store the name and size of the run-time system file, for use later 
when memory is allocated, then proceed to set the next default. 

3.9.3 Specifying the Instailation Name 

After you select the default run-time system and error message files, 
DEFAULT asks you to specify the installation name. This name is printed in 
the LOGIN identifying message and is the error message associated with error 
number 0. The name must be a string of 1 to 15 printable characters including 
spaces. If your console keyboard has lower-case input capability, you can type 
the installation name in upper and lower case. The following example illus- 
trates the procedure. 

Installation name? *Time Sharing* 

3.9.4 Assigning and Aliocating IVIemory 

The initialization code allows you to allocate a specific area of memory to the 
default run-time system, to lock and unlock areas of memory from use, and to 
allocate a certain portion of memory to the extended buffer pool. 

If you have never set memory allocation defaults for this SIL, DEFAULT 
automatically sets the defaults and prints a memory allocation table. If you 
have previously set defaults for this SIL, DEFAULT checks the defaults 
against the actual memory configuration of the PDP-11. If the default mem- 
ory allocation table marks any nonexistent memory as in use, DEFAULT 
prints a warning message then resets the defaults and prints the memory 
allocation table. Also, if the default memory allocation table marks any exis- 
tent memory as nonexistent, DEFAULT prints a warning message, resets the 
defaults and then prints the memory allocation table. 

NOTE 

In DEFAULT, if new memory has been added or removed, then 
INTT automatically resets the Memory Allocation Table and 
prints a message indicating its action. After INIT resets the 
table, you may need to respecify any memory allocation 
changes that you made, such as where XBUF is located. 
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If you installed a new default run-time system earlier in the DEFAULT proce- 
dure, DEFAULT scans the allocation table for a place for it. DEFAULT 
positions the run-time system if it finds enough contiguous space; it resets the 
entire allocation table if sufficient contiguous space is not available. It then 
informs you of its actions. 

Next, if you previously set defaults and the allocation table is still valid, 
DEFAULT prints the question ANY MEMORY ALLOCATION CHANGES. 
Table 3-17 lists the possible responses. 

Table 3-17: Possible Responses to ANY MEMORY ALLOCATION 
CHANGES Question 



Response(s) 



NO, OLD, O, or 
LINE FEED key 

RETURN key 



YES 



CTRL/C 



Meaning 



Causes currently established memory allocation assignments to remain 
unchanged and the next question, CRASH DUMP?, to be printed. 

Causes an explanatory form of the question to be printed, after which 
you can type your response. 

Causes TABLE SUBOPTION? to be printed. See Table 3-18 for a list 
of table suboptions. 

Causes execution to be aborted and the OPTION: prompt to be 
printed. 



In all cases where DEFAULT sets the allocation table, the first question it 
prints is TABLE SUBOPTION. Table 3-18 summarizes the memory alloca- 
tion table suboptions. You can abbreviate the name of any suboption to the 
first two characters. 

Table 3-18: Memory Allocation Table Suboptions 



Suboption 



LIST 

PARITY 

RESET 

LOCK 

UNLOCK 

RTS 

XBUF 

MAP 



Purpose 



Lists the memory allocation table. 

Lists the parity memory configuration. 

Lets the initialization code reset the memory allocation table. 

Locks portions of memory. 

Unlocks portions of memory. 

Moves the default run-time system. 

Allocates memory for the extended buffer pool. 

Specifies the amount of extended buffer space to be mapped with UNIBUS 
Mapping Registers. 



When you have made all memory allocation changes, exit from the table 
suboptions by typing EXIT, EX, or pressing LINE FEED. The DEFAULT 
option then advances to the crash dump questions. 
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Questions in several of the suboptions ask you to specify a memory address or 
a range of memory addresses. You can specify an address in either of the 
following two formats: 

1. Give the absolute address as a four to eight digit octal address. The octal 
number must be a multiple of 4000 (8) that is less than or equal to 
16774000. 

2. Give the K address as a decimal number followed by the letter K. The 
decimal number must be in the range from to 1919. 

Specify a range of addresses by typing either two addresses separated by a 
hyphen (e.g., 45K-47K) or by typing an address followed by a + and a number 
that represents the size of the range (for example 45K+3). 

3.9.4.1 Listing the iVIemory Ailocation Tabie — The LIST suboption prints the 
current allocation table on the console terminal. This table shows how each 
block of memory is being used. It provides information on the following: 

• the sizes of the RSTS/E Monitor and default run- time system. 

• the amount of memory available for user jobs. 

• which portions of memory are locked. 

• which portions of memory are assigned to the extended buffer pool. 

• the total amount of memory on the computer. 

The following is a listing for a large system: 

Table suboption? LI 
Memory allocation table: 



OK: 


00000000 


- 001G4777 ( 


29K) 


! EXEC 


29K: 


001G4000 


- 002G3777 < 


16K) 


: RTS (BASaF) 


45K: 


002 G 4000 


- 005G7777 ( 


80K) 


: XBUF 


9aK: 


00570000 


- 02777777 ( 


290K) 


: USER 


38aK: 


03000000 


- End 




: NXM 



Table suboption? 

Each row of the memory allocation breakdown includes the following, in 
order: 

1. the start of this range (in K words). 

2. the starting and ending octal addresses for this range. 

3. the amount of memory this range occupies (in K words). 

4. the purpose for which this memory is used. 

Table 3-19 explains the symbols in the memory allocation table. 
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Table 3-19: Memory Allocation Table Symbols 



Symbol 


Meaning 


EXEC 


Occupied by RSTS/E Monitor (Executive). 




RTS 


Occupied by the default run-time system, which 


is named in parentheses. 


USER 


Available for user space. 




LOCKED 


Unavailable for use (locked). 




XBUF 


Reserved for extended buffer pool. 




NXM 


Does not exist (nonexistent) on this PDP-11. 





You can use the LIST suboption as often as you need during DEFAULT as 
well as at start-up time. Keep a copy of the final memory allocation break- 
down with other system management information for future reference. 

3.9.4.2 Listing the Parity i\/lemory Configuration — With the PARITY subop- 
tion, you can identify and locate the various types of parity memory on the 
computer. This suboption is used primarily as a diagnostic tool. DIGITAL 
field service personnel can use it to verify the memory configuration when 
they install the PDP-11. The PARITY suboption looks at the hardware parity 
registers to ascertain the types of memory (parity memory, interleaved parity 
memory, or nonparity memory) on the computer. 

On a PDP-11/70, this suboption produces the following response: 

Table suboption? PARITY 

Parity register usa^e: 

All memory is 11/70 parity m e m o r y 

Table suboption? 

A typical printout for a PDP-11 other than an 11/70 might be the following: 

Table suboption? Parity 
Parity register usa^e: 



OK: 


00000000 - 


- 00137777 ( 


24K) 


00 


2^K: 


00140000 - 


- 00177777 ( 


8K) 


06 


32K: 


00200000 - 


- 00277777 ( 


ISK) 


10 (NA) 


4BK: 


00300000 - 


- 00377777 ( 


IGK) 


la(NA) 


B4K: 


00400000 - 


- End 




NXM 



Table suboption? 



Table 3-20 defines the parity type codes. The value nn and mm are the last 
two octal digits of the address of the parity register that controls that section 
of memory. Up to 16 parity registers can exist. They are in the address range 
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772100 to 772136. When the system detects a parity error, the parity register 
responsible for that section of memory usually contains information on the 
location of the last error discovered. The code NA indicates that the parity 
register contains no error address information. All parity core memory returns 
error address information. 

Table 3-20: Parity Type Codes 



Symbol 


Meaning 


NO 


Nonparity memory. 


NXM 


Nonexistent memory. 


nn/mm 


Interleaved parity memory with address information. 


nn 


Parity memory with address information. 


nn(NA) 


Parity memory with no address information. 


nn(ECC) 


Memory with ECC hardware. 


nn(ECC)/mm(ECC) 


Interleaved memory with ECC hardware. 



In interleaved memory, alternate banks respond to sequential memory 
addresses. In the following example, parity register 00 responds to the first 
address (000000), while parity register 02 responds to the next address 
(000002) and so on. 



ddress 


Parity Register 


000000 


00 


000002 


02 


000004 


00 


000006 


02 


000010 


00 


000012 


02 



Core memory is interleaved because core memories are destructive read-out 
devices. After each read from a core memory, the system must restore the 
original data. However, once the processor or DMA device receives the data it 
requested, it can go on to other things (presumably another memory access) 
during the restore cycle in the memory bank just accessed. The bank remains 
busy until the restore cycle completes. When memory is interleaved, the prob- 
ability is low that the same bank of memory will be accessed on the next 
memory cycle. Hence, interleaving allows some overlap of memory read opera- 
tions and results in faster program execution. 

EICC MOS memory is interleaved because it takes time for the memory con- 
troller to determine what error-correction bits to store with the data on a write 
operation. After the memory has accepted the data and the processor or DMA 
device is allowed to continue, it remains busy until it has stored the data and 
new ECC bits. When memory is interleaved, the probability is low that the 
same bank of memory will be accessed on the next memory cycle. Hence, 
interleaving allows some overlap of memory write operations and results in 
faster program execution. 
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3.9.4.3 Resetting the Memory Allocation — The RESET table suboption in- 
structs the initialization code to set up the memory allocation table according 
to the following rules: 

1. Place the default run-time system in low memory immediately after the 
monitor. 

2. Do not reserve any memory for the extended buffer pool. Release any 
memory previously allocated to the extended buffer pool. 

3. Do not lock any memory. Release to user space any memory that was 
previously locked. 

4. Find any new memory on the system and allocate it to user space. 
The following example shows the effects of the RESET suboption: 

Table suboption? LIST 



M e m r 


/' allocatioi 


1 table: 






OK: 


00000000 - 


00213777 


35K) 


EXEC 


35K: 


00214000 - 


00307777 


15K) 


RTS (BASIC) 


50K: 


00310000 - 


00477777 


30K) 


USER 


SOK: 


00500000 - 


00503777 


IK) 


LOCK 


81K: 


00504000 - 


00757777 


43K) 


USER 


124K: 


007G0000 - 


End 




NXM 



Table suboption? RESET 
Table suboption? LIST 
Memory allocation table 



OK 

35K 

50K 

124K 




0214 
3 1 
7 G 



00213777 
00307777 
00757777 
End 



35K) 
15K) 
74K) 



EXEC 

RTS (BASIC) 

USER 

NXM 



Table suboption? 

The first use of the LIST suboption shows memory locked and allocated to the 
extended buffer pool. After the use of the RESET suboption, the LIST subop- 
tion shows that the XBUF and LOCKed areas of memory have been released 
to user space. 

You may use RESET to remove all user set memory allocations, for example 
locked portions of memory, XBUF, and non-standard placement of the run- 
time system. Generally, this is its only use. 

3.9.4.4 Locking Portions of Memory — The LOCK suboption locks out certain 
portions of memory to prevent the use of that memory during time sharing. 
Use LOCK to avoid disruption of system operation when a section of memory 
is known to be defective. If sufficient undamaged memory remains, you can 
start the system for normal time sharing. 
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When you request the LOCK suboption, DEFAULT responds by asking for a 
LOCK ADDRESS. Your response should be an address or range of addresses 
to lock. The following example illustrates the procedure: 



Table suboption? LOCK 

LocK address is? 80K 
Table suboption? LIST 
Memory allocation table 



OK 
35K 
50K 
80 K 
81K 




0214 
310 
5 
5 4 



1 2 4 K : 7 G 



00213777 
00307777 
00477777 
00503777 
00757777 
End 



35K ) 
15K) 
30K) 
IK) 
43K) 



EXEC 

RTS (BASIC 

USER 

LOCK 

USER 

NXM 



Table suboption? 

Certain restrictions apply to locking out memory. You cannot lock memory in 
use by the monitor because the monitor cannot be relocated to another section 
of memory. Similarly, you cannot lock memory currently allocated to the 
default run-time system or to XBUF until the run-time system or extended 
buffer space is relocated to a usable area of memory. If you try to lock out a 
portion of memory already in use by the monitor, default run-time system, or 
as extended buffer space, LOCK prints the message PART OF THAT AREA 
IS ALREADY IN USE. Finally, to remove a full bank of memory from use, 
locate all of the 4, 8, 16, 32, 64, or 128 contiguous IK sections that make up 
the hardware bank. If the bad memory bank is interleaved, you must lock an 
amount of memory equal to twice its length. 

Certain types of memory failures affect only one word. Other types affect 
larger sections or even the full hardware bank. Carefully analyze any memory 
failure to determine the IK section of memory to lock. After locking memory, 
study the resultant memory configuration to ensure that sufficient contiguous 
user memory is available to run your installation's programs. 

RSTS/E can continue running with certain types of memory failures. On 
systems with parity memory, the error handling routines in the monitor log 
parity errors. The recovery procedures depend on the use of the offending 
section of memory at the time of the error. Consider the following four cases of 
memory failure and recovery procedures. 

In the first case, a parity error occurs when the monitor is running. Since 
continued system operation would be risky, the monitor logs the error, takes a 
crash dump (if the crash dump facililty is enabled), and reloads the system. 
When the system restarts, use the ANALYS program to extract the error log 
information from the CRASH. SYS file. An ERRDIS report, automatically 
appended to the ANALYS report, provides sufficient information to identify 
the section that should be locked out. If the error occurred in the default run- 
time system or extended buffer memory, you can relocate these items and lock 
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the section. If the error was in monitor memory, the hardware must be re- 
paired or reconfigured. In either case, a hard failure may prevent the system 
from running at all and, hence, you can run neither ANALYS nor ERRDIS. 
The only recourse in such cases is to run memory diagnostics to locate the 
problem. If the failure was transient, you can shut down the system to lock 
out memory or you can continue time sharing. At some point, memory diag- 
nostics should be run to reproduce the failure, if possible. 

In the second case, a parity error occurs when a user job is running. The parity 
error handling routines determine whether a single user is affected (i.e., re- 
sides in the malfunctioning section) or more than one user is affected. If more 
than one user is affected, the system is reloaded as described previously. If a 
single user is affected, the system aborts that user with the error message 
7MEM0RY PARITY FAILURE. The monitor logs the error, automatically 
locks out the section from future use (for the duration of the time-sharing 
session), and the system continues running. You should lock out the bad 
section of memory (until repaired) using the LOCK suboption the next time 
you start the system. 

In the third case, multiple parity errors occur in rapid succession. RSTS/E 
halts at location 54 (56 is displayed) if a second parity error occurs while the 
system is processing the first parity error. Use memory diagnostics to locate 
the failing memory. 

The fourth case concerns a memory cache parity error. If the hardware mem- 
ory cache malfunctions and causes a parity error, the hardware again retrieves 
the needed word from main memory and causes a warning parity trap to 
occur. RSTS/E logs this type of error. If the error occurs twice within one 
minute, RSTS/E disables the part of the cache causing the malfunction. 
RSTS/E continues running but with degraded performance. The system does 
not print a message, but two successive errors within the same minute in the 
ERRDIS print-out should alert you. 

On systems without parity or ECC memory, the software cannot detect or 
locate a memory failure. Programs may get incorrect results, memory man- 
agement errors may occur, or any number of random problems may happen. 
At worst, the system may crash with misleading clues as to the cause. 

3.9.4.5 Unlocking Portions of Memory — The UNLOCK suboption frees a 
previously locked portion of memory for use by user jobs, the default run-time 
system, or the extended buffer pool. The following is an example of this 
suboption. 

Table suboption? LIST 
Memory allocation table: 



OK: 


00000000 - 


- 00213777 ( 


35K) 


EXEC 


35K: 


00214000 - 


■ 00307777 ( 


15K) 


RTS (BASIC) 


50K: 


00310000 - 


- 00477777 ( 


30K ) 


USER 


80K: 


00500000 - 


- 00503777 ( 


IK) 


LOCK 


SIK: 


00504000 - 


- 00757777 ( 


43K) 


USER 


24K: 


007 GOO 00 - 


- End 




NXM 



3-82 Tailoring the SYSGEN System 



Table subotpion? UNLOCK 

Un 1 c K address is? 80K 

Table s u b o p t i o n ? LIST 

Memory allocation table: 

K ; - 00213777 ( 

35K: 00214000 - 00307777 ( 

50Ks 00310000 - 00757777 ( 

124K: 007B0000 ~ End 



35K) 
15K) 



EXEC 

RTS (BASIC) 

USER 

NXM 



Table s u b o p t i o n ? 

3.9.4.6 Positioning tlie Defauit Run-Time System — The RTS suboption places 
the default run-time system (usually BASIC-PLUS, BASIC-PLUS-2, or 
RSX) anywhere in the first 124K of memory. It is generally advantageous to 
place the default run-time system (or extended buffer space) in solid-state 
memory, when it is available. If your system has a mixture of fast and slow 
core memory, you may gain a small advantage by locating the default run- 
time system in fast core. Generally, the only reason to position BASIC-PLUS 
or BASIC-PLUS-2 on systems without solid-state memory is to avoid defec- 
tive memory. If you do not position the run- time system, DEFAULT places it 
immediately after the RSTS/E Monitor in the lowest physical memory 
addresses. 

When you specify the RTS suboption, DEFAULT responds with NEW RUN 
TIME SYSTEM ADDRESS IS?. Reply with the address (in the format de- 
scribed in Section 3.9.4) at which you choose to start the run-time system. 
There must be sufficient free contiguous space for the default run-time system 
between the starting address you specify and 124K. The following example 
illustrates the use of RTS. 



M e (r) r >' allocation table: 



OK 
24K 
4 OK 
G^K 




1 U 
2 4 
4 



00137777 ( 
00237777 ( 
00377777 ( 
End 



24K) 
IBK) 
24K ) 



EXEC 

RTS (BASIC) 

USER 

NXM 



Table suboption? PAR IT' 



Parity refJister usa^e 



OK 
24K 
32K 
4SK 

saK 




1 4 
2 
3 
4 



00137777 ( 
00177777 ( 
00277777 ( 
00377777 ( 
End 



24K) 

SK) 

ISK) 

IBK ) 





OB 

10 (NA) 

la(NA) 

NXM 



Table suboption? RTS 

New Run Time System address is? 4 8 K 
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Table sub option? LIST 

Memory allocation table: 

OK: 00000000 - 00137777 ( 24K ) 

24K: 00140000 - 00277777 ( 24K ) 

<a8K: 00300000 - 00377777 ( IGK) 

G 4 K : 4 - E n d 



Table s u b o p t i o n ' 



EXEC 

USER 

RTS (BASIC) 

NXM 



Under certain conditions, you should not place the default run-time system m 
solid-state memory. Consider the following configuration where the memory 
allocated to the monitor is shown but, for the purpose of this illustration, the 
location of the default run-time system is not shown. 

Locations 0000000 through 0117777 (20K) are RSTS Executive 
Locations 0120000 through 0177777 (12K) are available core 
Locations 0200000 through 0277777 (16K) are available solid-state memory 
Locations 0300000 through 0377777 (16K) are available core 
Locations 0400000 upwards are nonexistent. 

Assume that the size of BASIC-PLUS is 14K words. If BASIC-PLUS is 1^ 
cated at address 0200000, the remaining user memory is divided into one 12K 
section below and one lOK section above. Because the system loads user job 
images into contiguous physical memory, no program larger than 12K can run 
with this memory configuration. In this system, BASIC-PLUS should be 
placed at the high end of available memory starting address 250000, leaving 
22K words of contiguous memory for user jobs between the monitor and 
BASIC-PLUS. This configuration allows 16K programs to be run at the ex- 
pense of not using the high speed solid-state memory to full advantage. Only 
8K words of memory are used for BASIC-PLUS while the other 8K words 
are part of the 22K words of user memory. Ensure that the location of 
BASIC-PLUS on your system leaves sufficient memory for user jobs. 

3.9.4.7 Reserving Memory as Extended Buffer Space — You can reserve mem- 
ory as extended buffer space with the XBUF suboption. Message send/receive, 
the DECnet/E package, the RSTS/2780 package, the KMC support package, 
the data caching module, the FIP buffering module, and optionally, the line 
printer driver use this reserved memory. 

DIGITAL recommends that you allocate extended buffer space on all systems 
with sufficient memory. The amount of extended buffer space you should 
allocate depends on the type of processing done on the system. The FIP 
buffering module uses extended buffer space in 512-byte (256-word) sections, 
and can use at most 175K words of extended buffer space. If you allocate more 
than 8K words of extended buffer space, the FIP buffering module will not try 
to use small buffers for disk directory storage at all. Data caching can use all 
the XBUF that can be allocated on a system (about 450K words). 

The message send/receive code uses extended buffer space to store messages. 
The amount of space it uses depends on the length and number of outstanding 
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messages on the system. Each message requires a number of bytes equal to 
the length of the message plus 8 bytes, rounded up to the next multiple of 64 
bytes. A message always consumes at least 64 bytes of extended buffer space; 
it can consume at most 576 bytes. 

DECnet/E package uses extended buffer space to hold inter-job messages. 
DECnet/E requires at least 4K words of extended buffer space for optimal 
performance. For the RSTS/2780 package, you should allocate an additional 
IK words of XBUF space. 

The DECnet/E package and message send/receive code use buffer space in 
large, contiguous sections. If you are unable to allocate sufficient extended 
space for these facilities, you may need to configure more small buffers 
(Section 4.2.11.3). 

When the extended buffering line printer driver is configured, each line 
printer on the system will use up to approximately 2.5K words of XBUF. 

When you request the XBUF suboption, DEFAULT responds by asking for 
the extended buffer address range. You can reply with an address or a range of 
addresses identifying the memory to reserve. (Refer to Section 3.9.4 for a 
description of the format for your response.) XBUF memory must be in the 
range 00100000 (16K) to 03777700 (511K). The allocation table must currently 
designate the memory you plan to reserve for extended buffer space as either 
USER or XBUF memory. If high-speed solid-state memory is available, you 
may place the XBUF space in it to further enhance system performance. 

When you allocate memory to extended buffer space, DEFAULT releases any 
memory previously allocated for that purpose. You can reserve only one region 
of memory as extended buffer space. To release previously allocated XBUF 
memory to USER space, type RE (or REMOVE). 

The following example illustrates the use of the XBUF suboption. 

Table suboption? XBUF 

Extended buffer address rande is? 115K-127K 



Table 


suboption? 


LI 






M e (ii r V 


' allocation 


table: 






OK" 


00000000 - 


00147777 ( 


2BK) 


: EXEC 


2GK 


00150000 - 


00247777 ( 


16K) 


s RTS (BASIC) 


^2K 


00250000 - 


00713777 ( 


73K) 


: USER 


115K 


00714000 - 


00777777 ( 


13K) 


: XBUF 


128K 


01000000 - 


End 




s NXM 


Table 


suboption? 









The SIZE OF MAPPED XBUF question allows you to specify the amount 
of extended buffer space to be mapped with UNIBUS Mapping Registers. 
Certain device controllers transfer information directly to memory. On the 
PDP-11/70, these device controllers require special registers, called UNIBUS 
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Mapping Registers, in order to perform direct device to memory transfers. 
You can use this question to specify the portion of memory to which these 
transfers are sent. As a result, the controller will only be able to transfer the 
data to the mapped area of memory. 

The KMCll and DMCll controllers, and the XBUF line printer driver re- 
quire that you map a portion of XBUF for their use. The portion of XBUF to 
be mapped defaults to the size of XBUF or 32K, whichever is smaller. You 
invoke the SIZE OF MAPPED XBUF question by typing MAP in response to 
the following question: 

Table Sub option: MAP 

After you press RETURN, DEFAULT prints. 

Size of mapped XBUF <N> K? 

Press LINE FEED to accept the default printed in angle brackets or enter a 
number in K words from zero to the size of XBUF. After you terminate your 
response, you return to the TABLE SUBOPTION prompt. 



3.9.5 Setting the Cache Cluster Size 

DEFAULT prints the CACHE CLUSTER SIZE prompt if you answered YES 
to the EXTENDED DATA BUFFERING question asked during the configu- 
ration dialogue. As a result of this response, you will have the disk data 
caching feature installed in your monitor. Before you can use data caching, 
however, the monitor requires that you specify the cluster size of the cache. 
Since data caching allows the monitor to store certain user requested data in a 
portion of memory, called a cache, the monitor must know how many blocks 
of disk data are to be read into the cache each time a disk data request is 
made. When you respond to the CACHE CLUSTER SIZE question, you tell 
the monitor how many blocks of data (as a cluster) you want read into the 
cache area of memory as a result of a disk read. That is, the size of the cache 
cluster (1, 2, 4, or 8 blocks) determines the amount of data that is considered 
as a unit in a disk read request. 

The prompt appears in the DEFAULT dialogue as follows: 

Cache cluster size <4>? (© 

Choose the n u (it b e r of 512 b y t e b 1 o c K s to be treated as a unit for 
the purposes of disk data caching. LejSal Malues are 1» 2> ^ t 8. 

Cache cluster size < 4 > ? 8 

If you press RETURN, DEFAULT prints an explanatory message. Rather 
than press LINE FEED to accept the default value of 4, you type the number 
8. Eight blocks of data will be read into the cache after each disk read request. 
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The cache cluster size you choose will affect your system's throughput. There- 
fore, keep the following guidelines in mind when making your choice. The 
data in the cache is organized in clusters of 1, 2, 4, and 8 blocks. If the cache 
cluster size is greater than the file cluster size of a noncontinguous file or a 
directory that is being cached, some of the blocks installed in the cluster will 
probably contain unrelated data. On the other hand, if the cache cluster size 
is too small, not all the benefits of caching will be available. A read of a file 
cluster larger than the cache cluster size may need to be split into two sepa- 
rate reads in order to install the data in the two different cache clusters. 
RSTS/E will not split a read if doing so would cause more than two physical 
block read operations. Furthermore, if a file is being read sequentially, one 
block -at a time, then each time a cluster is installed, all other blocks in that 
cluster can be read without another disk access. 

One way to resolve these conflicts is to consider the number of cache clusters 
that will fit in XBUF. If XBUF is, for example, 20K words long, and the cache 
cluster size is 2 blocks, almost 40 clusters will fit. This is probably reasonable 
for a system that typically runs 20 jobs. If the cache cluster size were in- 
creased to 8 blocks, fewer than 10 cache clusters would fit in cache, and 
performance might suffer. Refer to the RSTS/E System Manager's Guide for a 
description of data caching. 

3.9.6 Enabling and Disabling the Crasti Dump Facility 

After you have set the memory allocation, DEFAULT prints the current 
status of the crash dump facility. The message is one of the following: 

Y u currently h a m e crash d u w p enabled, 

Y u currently h a u e crash d u u\p disabled. 

DEFAULT then checks that the file CRASH.SYS 1) is present in account 
[0,1] on the system disk, 2) is large enough for the monitor and 3) is contigu- 
ous. If the file does not meet all three of these conditons, DEFAULT prints an 
appropriate warning text. If CRASH.SYS does not meet the required condi- 
tions, and you want to enable crash dump, use REFRESH to correct 
CRASH.SYS before starting the system. 

After checking the file and printing a message (if necessary), DEFAULT 
prints the CRASH DUMP question. Reply YES to enable crash dump, or NO 
to disable crash dump. If the CRASH.SYS file is invalid, but you enable crash 
dump anyway, DEFAULT prints no further warning. 

3.9.7 Specifying the Labelling Defaults for Magnetic Tape 

After completing the crash dump section, DEFAULT asks the user to set the 
default for magnetic tape labelling. Individual jobs can reset and restore the 
tape labelling default during time sharing. A job sets its default with the 
ASSIGN command, described in the RSTS/E System User's Guide. An indi- 
vidual program sets its default with the MODE option of the OPEN state- 
ment when it opens a file on the tape. (The RSTS/E Programming Manual 
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describes the MODE option with magnetic tape.) You can set and reset the 
system default only by using the DEFAULT option. Note that the default 
labelling format for the SYSGEN system must be DOS. 

DEFAULT prints the following query, with NONE, DOS, or ANSI in 
parentheses to indicate the current setting. 

Magtape labelling default < n o n e > ? 

Table 3-21 lists the valid responses to the question. 

Table 3-21: Valid Responses to MAGTAPE LABELLING DEFAULT 
Question 



Response(s) 


Meaning 


LINE FEED key 
or OLD 

DOS 

ANSI 


Retain the current default. Pressing LINE FEED or typing OLD will 
not be accepted if the current default is NONE. 

Set the default format to DOS/BATCH-11 labelling. The default for 
the SYSGEN monitor and for building of the system library (if the 
distribution medium is magnetic tape) must be DOS. 

Set the default format to ANSI standard labelling. 



After you specify the magnetic tape labelling default, DEFAULT issues the 
PREFERRED CLOCK prompt. 

3.9.8 Specifying the Preferred System Clock 

Your hardware configuration can include one, or both, of the following system 
clocks. You must specify which clock will be used to provide system timing. 

KW11-L Line Time Clock - The KWll-L divides system time into intervals 
based on the AC line frequency of the power source used to run your computer 
system. AC line frequency can be either 50 Hz (the standard in many coun- 
tries) or 60 Hz (the standard in the United States). 

KW11-P Programmable Real-Time Clock - The KWll-P can use the AC line 
frequency of the power source to provide a system time base, or it can be set to 
provide a crystal-controlled time base independent of the power source. Using 
the KWll-P crystal-controlled time base is beneficial in areas where the 
possible fluctuations in AC line frequency would adversely affect system tim- 
ing. The interrupt time base for a KWll-P can be set from 50 to 1000 
interrupts/second (in multiples of 50). DIGITAL recommends that you set the 
interrupt rate to 100 interrupts/second. 

DEFAULT lets you control which clock will be used to provide a system time 
base, and, if you specify a KWll-P clock, the time base to be used for the 

system. 

DEFAULT prints the following question (the current default condition ap- 
pears in parentheses): 

PREFERRED CLOCK (current default>? 

To accept the current default, press LINE FEED. 
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If you have only a KWll-L clock, or you have both clocks but prefer to use the 
KWll-L, respond by typing L. The system will then use the KWll-L as the 
AC line frequency for a time base. 

If you have only a KWll-P clock, or you have both clocks but prefer to use the 
KWll-P, respond by typing P. The DEFAULT routines then print the query: 

INTERRUPT FREQUENCY? 

Respond by typing LINE to have the KWll-P use the AC line frequency for a 
time base. 

Respond with a number from 50 to 1000 to have the system use the KWll-P's 
crystal oscillator (at that interrupt rate) for the time base. Your response 
must be a multiple of 50. 

3.9.9 Specifying Date and Time Formats 

DEFAULT then prints the following question (the current default condition 
in parentheses): 

DATE FORMAT (current default)? 

To accept the current default, press LINE FEED. 

Respond with A (for ALPHABETIC) to change the date format to dd-mmm-yy 
format. (For example, lO-JUN-79.) 

Respond with N (for NUMERIC) to change the date format to yy.mm.dd 
format. (For example, 79.06.10.) 

Next, DEFAULT prints the following question (the current default condition 
in parentheses): 

TIME FORMAT (current .default)-? 

To accept the current default, press LINE FEED. 

Respond with AM/PM to change the time format to nn:nn AM/PM format. 
(For example, 05:13 PM.) 

Respond with 24-HOUR to change the time format to nn:nn format. (For 
example, 17:13.) 

The result of the dialogue is that you have maintained or altered the current 
defaults for reporting date and time to users of your system. 

3.9.10 Specifying the Power Faii Recovery Delay 

RSTS/E systems attempt to recover from a momentary power failure by per- 
forming an automatic restart procedure. A momentary power failure occurs 
whenever the AC power drops below 95 volts for 110 volt power (or 190 volts 
for 220 volt power) or outside a limit of 47 to 63 Hz (AC power). RSTS/E 
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allows you to specify the delay factor (in seconds) before the system attempts 
to restart after a momentary power failure. The delay can be from 1 to 300 
seconds (5 minutes). Specifying a relatively long delay factor ensures that all 
disk devices are ready before the system attempts to auto-restart. (For infor- 
mation on the recovery times required by various RSTS/E devices, consult the 
appropriate hardware publications.) Refer to the RSTS/E System Manager's 
Guide for further information on the RSTS/E auto-restart procedures. 

3.9.11 DEFAULT Option Dialogue Error IVIessages 

Table 3-22 explains the error messages that can occur during the DEFAULT 
option dialogue. 

Table 3-22: DEFAULT Dialogue Error Messages 



Message and Meaning 



EXTENDED BUFFER SPACE NOT IN RANGE 00100000 (IGK) TO 
03777700(51 IK) 

The extended buffer space must fit entirely within the specified range. 

FILE NOT CONTIGUOUS 

The file you specified is not contiguous on disk. The default run-time 
system file and error message file must be contiguous. 

FILE NOT FOUND 

The initialization code did not find the file you specified on disk. 

ILLEGAL FILE NAME 

The filename you specified is not one to six alphanumeric characters. 

ILLEGAL IK SECTION ADDRESS SPECIFIED 

The address you specified is not a multiple of 4000(8) or is greater than 
1919K (16774000(8)). If you specified a range of addresses, the second of 
the two addresses must be greater than the first. 

ILLEGAL SUBOPTION GIOEN 

Your response to the TABLE SUBOPTION prompt is not a valid sub- 
option name. 

INMALID FILE FORMAT 

The error message file you specified is not exactly sixteen blocks long. 

INMALID MODULE FORMAT 

The run-time system SIL module is too long, too short, or has a high 
limit other than 177776(8). 

INOALID SIL FORMAT 

The run-time system file does not contain a valid SIL index. 

MUST FIT ENTIRELY BELON IZaK 

The region you specified for the run-time system extends beyond the 
system's upper limit of 124K. 

NAME MUST BE 1 TO 15 PRINTABLE CHARACTERS 

The installation name you typed is more than 15 characters long or 
contains unprintable characters. You cannot respond by pressing LINE 
FEED if no previously typed name is available. 



(continued on next page) 
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Table 3-22: DEFAULT Dialogue Error Messages (Cont.) 



Message and Meaning 



PART OF THAT AREA IS ALREADY IN USE 

The region you specified is unavailable for use. The region must cur- 
rently be allocated to USER space or to the purpose for which you wish 
to allocate it. (You can allocate space marked for RTS to the run-time 

system.) 

PART OF THAT AREA IS NOT LOCKED 

Part of the region you specified is not now locked and, therefore, you 
cannot unlock it. 

RTS IS NOT A KEYBOARD MONITOR 

The run-time system you specified is not a keyboard monitor. RSTS/E 
requires the default run-time system be a keyboard monitor (for exam- 
ple, BASIC-PLUS). 

TOO MANY MODULES 

The run-time system SIL contains more than one module. 



J 



Table 3-22 describes only the dialogue error messages. For information on 
other error messages that appear when you use the DEFAULT option, refer to 
Appendix A. 

3.10 Specifying Characteristics for Device Units 

You can specify the characteristics of device units in the installed SIL by 
using the SET option. SET contains a group of suboptions (summarized in 
Table 3-23). These suboptions allow you to enable and disable device units, 
set or remove modem control on keyboards, change line printer characteris- 
tics, and set or remove restrictions on the use of devices. The ability to enable 
and disable device units is particularly useful. If, for instance, one of two 
DECtape drives is not working properly, you can simply shut down the sys- 
tem, disable the malfunctioning unit, and restart time sharing. Repairs can be 
made while the system is in use. 

Table 3-23: SET Suboptions 



Suboption 


Function 


LIST 


Lists the status of a device. 


MODEM 


Enables modem control for keyboards. 


LOCAL 


Disables modem control for keyboards. 


LP 


Sets line printer characteristics. 


DISABLE 


Disables a device unit. 


ENABLE 


Enables a device unit. 


PRIV 


Sets restrictions on device use. 


UNPRIV 


Removes restrictions on device use. 
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To use the SET option, type SET or SE in response to the OPTION: prompt. 
In response, SET requests a suboption name. Type a suboption name from 
Table 3-23. (You need to type only the first 2 characters.) SET executes the 
suboptions's dialogue, makes the requested changes in the installed SIL, and 
returns to the SET SUBOPTION question. When you have made all the 
necessary settings, type EXIT or press LINE FEED to return to the OPTION: 
prompt. 

3.10.1 Listing Device Status 

The LIST suboption lists the status of one or more devices in the installed 
monitor SIL. You can use LIST to verify changes made with other SET 
suboptions. 

To invoke LIST, type LIST, LIS, or LI in response to the SET SUBOPTION 
question. LIST responds by asking for the device to Hst. To list characteristics 
of only one unit, type the device name and unit number (for example, DL2). 
To list all units of a particular device, type the device name (for example, 
DL). To list a group of device units, type the device name and two unit 
numbers separated by a hyphen (as in DLl-3). Type ALL or press LINE 
FEED to list all devices supported by the installed SIL. 

The following is a sample listing using this suboption. 

SET suboption? LIST 
Device? ALL 

Name Control C o mm e n t s 



DFO 


RF: 


DSO 


RS: 


DSl 


RS: 


DKO 


RK: 


DLl 


RL: 


DL2 


RL: 


DL3 


RL: 


DM0 


RM: 


DM1 


RM: 


DPO 


RP: 


DPI 


RP: 


DRO 


RR: 


DRl 


RR: 


DBO 


RB: 


DBl 


RB: 


KBO 


TT: 


KBl 


PKO 


NLO 




PKO 




LPO 


LPO 


MTO 


TM: 


MTl 


TM: 


MMO 


TU: 


MMl 


TU: 


DTO 


TC: 


DTI 


TC: 



NOOMITCR »CR »NOEOT »FILL »NOCONTROL ^NOMTAB »BSEMULATE > width 80 
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In the listing, the first column contains the device name and unit number. 
The second column denotes the hardware controller associated with the 
device. For example, DM1 is associated with RM:, the RK06/RK07 disk con- 
troller. For terminal multiplexers and RXll diskettes, the second column also 
tells you the line number on the controller associated with each unit. For 
instance, KB32 may be attached to line 4 on the second DHll unit; thus the 
listing for KB32 would include the notation DH1:4. For pseudo keyboard 
units, this column includes the number of the pseudo keyboard associated 
with the keyboard unit. For example, if KBl is associated with a pseudo 
keyboard number 0, the listing for KBl includes the notation PKO. 

The final column contains comments about the unit. The comment 
DISABLED means that the unit is not available for use during time sharing. 
For keyboards, the comment MODEM means that modem control is enabled 
for that unit. For line printers, the third column includes the printer type (LP, 
LV, LS, or LA180) and width. If the line printer is lower case, this column also 
includes the comment LOWER CASE. The comment PRIVILEGED appears 
for device units that are accessible only to privileged jobs or programs. 

3.10.2 Enabling and Disabling Modem Control 

The MODEM suboption allows you to enable and the LOCAL suboption 
allows you to disable modem control on keyboards controlled by a DHll or 
DZll multiplexer. 

To enable modem control, use the MODEM suboption. In response to 
MODEM'S KB question, type the keyboard number or range of keyboard 
numbers for which modem control should be enabled. To exit from the subop- 
tion, press LINE FEED or type CTRL/Z. The following example illustrates 
the use of the MODEM suboption. 

SET suboption? MODEM 
KB? 27-30 
KB? © 

S E T 5 u b p t i n ? 

To disable modem control, use the LOCAL suboption. The format and exit 
procedures for LOCAL are the same as those for MODEM. 

3.10.3 Changing Line Printer Unit Characteristics 

Use the LP suboption to change the printer type, width, and case associated 
with any line printer unit on the system. The suboption requests the unit 
number (if the system includes more than one line printer) for which changes 
will be made, then prompts you for printer type, width, and case for that unit. 
Each prompt includes in parentheses the current setting for that unit. 

The line printer type can be LP, LV, LS, or LA180. If the line printer is not a 
standard DIGITAL line printer, you can set individual characteristics for it as 
described in Table 3-24. 
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Table 3-24: Line Printer Characteristics 



Name 


Function 


OMITCR 


Omits sending <CR> if next character is <LF>. 


NOOMITCR 


Always sends <CR> to the printer. 


CR 


Inserts <CR> before <LF>, <VT>, and <FF>. 


NOCR 


Instructs printer to perform implied <CR> before <LF>, 
<VT>, <FF>. 


FILL 


Inserts fill after form feeds. 


NOFILL 


Fill is not required after form feeds. 


CONTROL 


Sends non-printing characters to the printer. 


NOCONTROL 


Discards non-printing characters or uses uparrow mode. 


EOT 


Sends EOT (^D) to the printer. 


NOEOT 


Treats EOT like other non-printing characters. 


VTAB 


Sends vertical tabs to the printer. 


NOVTAB 


Treats vertical tabs like other non-printing characters. 


BSEMULATE 


Emulates the action of 'backspace' on the printer. 


BSREAL 


Indicates the printer has real backspace (carriage moves left). 


BSCONTROL 


Treats backspace like other non-printing characters. 



Unspecified characteristics take the following defaults: 

NOOMITCR, CR, NOEOT, FILL, NOCONTROL, NOVTAB, BSEMULATE 

The defined printer types are: 

LP = OMITCR,NOCR, NOEOT, FILL, NOCONTROL, NOVTAB, BSEMULATE 
LV = NOOMITCR, NOCR, EOT, NOFILL, NOCONTROL, NOVTAB, BSEMULATE 
LS = NOOMITCR, CR, NOEOT, NOFILL, CONTROL, VTAB, BSEMULATE 
LA180 - OMITCR, NOCR, NOEOT, FILL, NOCONTROL, NOVTAB, BSREAL 

The width setting for the line printer is a decimal number between 1 and 254, 
inclusive. The default width is 80 columns, if none is specified with the LP 
suboption. Listings produced during the SYSGEN process are intended to be 
printed on 132 column printers. The case setting is upper or lower case. The 
default setting is upper case only. After you set all characteristics for a printer 
unit, the suboption returns to the LP question. (If only one printer is on 
the system, the suboption does not return to LP? but exits to the SET 
SUBOPTION question.) Type a unit number to set characteristics for another 
unit; press LINE FEED to exit from the suboption. The following is an exam- 
ple of the LP suboption: 

SET suboption? LP 

Type (NOOMITCR fCR »NOEOT »FILL ^NOCONTROL »NOUTAB tBSEMULATE)? LP 

Width (80)? 132 

Lower case (no) ? YES 

SET suboption? EXIT 
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3.10.4 Enabling and Disabling Device Units 

The ENABLE and DISABLE suboptions allow you to make device units 
available or unavailable for time-sharing use. A time-sharing user who at- 
tempts to access a unit disabled with the DISABLE suboption receives the 
7DEVICE NOT AVAILABLE error message. 

The DISABLE suboption of SET differs from that of the HARDWR option in 
that SET allows you to disable a single unit on a controller without affecting 
any other units of the same type. HARDWR permits disabling of device 
controllers only. 

Use set's disable suboption when a particular unit has hardware prob- 
lems. If you disable the troublesome unit, time sharing can take place while 
the unit is being repaired. When the unit is working properly, reboot the 
system and enable the unit again. 

DISABLE and ENABLE also, in effect, allow you to configure a device unit 
that is not yet installed in the processor. You can include the unit at configu- 
ration time and disable it until it is installed. After its installation, you can 
enable it for time-sharing use. Disabling nonexistent units with the SET 
option suppresses the warning messages generated when the start-up code 
automatically disables them. 

To enable or disable a unit, type the appropriate suboption name (ENABLE 
or DISABLE, respectively). In response, the suboption asks the DEVICE 
question. You can disable any device unit except the console keyboard 
(KBO:). To enable or disable only one unit or range of units of a device, type 
the device name followed by the unit number or numbers, as in KBIO or 
KB8-12. The suboption makes the specified change and returns to the 
DEVICE question. To enable or disable several units of a single device, type 
only the device name in response to the question. The suboption next prompts 
vdth UNIT?. Reply with a number or range of numbers for the units to enable 
or disable. For the ENABLE suboption only, you can type ALL to enable all 
units of that device. The suboption makes the specified changes and repeats 
the question. Specify another unit or range of units or press LINE FEED to 
return to the DEVICE question. 

Once you are at the DEVICE question, you can type another device name to 
enable or disable additional device units, or you can press LINE FEED to 
return to the SET SUBOPTION question. 

The following example demonstrates the DISABLE suboption. The dialogue 
for the ENABLE suboption is exactly the same. 

SET suboption? DISABLE 
DeMice? KB 
Unit? 8-12 
Unit? © 
Deuice? © 

SET suboption? 
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3.10.5 Restricting the Use of Devices 

The PRIV and UNPRIV suboptions allow you to place and remove restrictions 
on the use of devices and device units on the RSTS/E system. RSTS/E time 
sharing normally allows any user job to use any device. 

By using the PRIV suboption, you can permit only privileged jobs to use 
specified devices. A permanently privileged user (one whose project number is 
1) can use any restricted device and can reassign a restricted device to an 
unprivileged job. An unprivileged job gains ownership of a restricted device by 
running a privileged program that assigns the device or by having a privileged 
job reassign the device to it. The unprivileged job loses ownership of the 
device when it logs out or issues a DEASSIGN command. An unprivileged job 
can also gain access to a restricted device by running a privileged program 
that uses the device. If the program does not assign the device, the job has 
access to the device only while the privileged program executes. When execu- 
tion of the program is complete, the device is once again inaccessible to the 
job. 

You can restrict the use of any device except disks and the null device. 
Restrictions on keyboard access do not prevent jobs from logging in. Any job 
can log into a restricted keyboard. The restrictions prevent an unprivileged 
job from opening or assigning a keyboard other than its console keyboard 
(KB:). 

To place or remove restrictions on the use of one or more devices, use the 
PRIV or UNPRIV suboptions. In response to the SET SUBOPTION question, 
type the name of the suboption you need to use. The suboption then prints the 
DEVICE question. Type the name of the device for which you need to set or 
remove restrictions. (When using the UNPRIV suboption, you can type ALL 
in response to the DEVICE question to free access to all devices. UNPRIV 
then returns to the SET SUBOPTION question.) After you specify a device 
name, the suboption prints the UNIT question. Respond by typing a unit 
number, range of unit numbers, or ALL. The suboption enacts the requested 
changes and repeats the UNIT question. Type another unit number or range 
of unit numbers, or press LINE FEED to return to the DEVICE question. To 
set or remove restrictions for another device, type the name of the device. 
Press LINE FEED to return to the SET SUBOPTION question. 

The following example shows the use of PRIV to make the use of keyboards a 
privileged operation. 

Option: ^ E 

SET s'-iboption? PRI"^ 
Deuice? KB 
Unit? Al-L 
Deuice? © 

SET suboption? © 



Option: 
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3.10.6 SET Option Dialogue Error IVlessages 

Table 3-25 summarizes the errors that can occur during the SET option 
dialogue. 

Table 3-25: SET Dialogue Error Messages 



Suboption 


Message and Meaning 


DISABLE 
MODEM, LOCAL 

MODEM, LOCAL, 
LP 

ENABLE, DISABLE, 
PRIV, UNPRIV 

ENABLE, DISABLE, 
LP, PRIV, UNPRIV 

MODEM 

PRIV, UNPRIV 


CAN'T DISABLE KBO: 

You specified KBO:, which cannot be disabled. 

INMALID KEYBOARD NUMBER 

The keyboard number you typed is greater than the maximum 

allowed. 

INUALID RESPONSE 

The number you typed is in an incorrect format. 

INVALID RESPONSE 

The device you specified is not configured in the installed monitor 

SIL. Use the LIST suboption to obtain a list of valid device names. 

INVALID UNIT NUMBER 

The unit number you typed is not a decimal number, or is too large 
for the installed SIL. If you typed a range of unit numbers, they 
must be in ascending order. 

KBnn: CANNOT HAUE MODEM CONTROL 

KBnn: is not on a DHll or DZll interface. Therefore, it cannot 

have modem control. 

NOT POSSIBLE ON DISK UNIT 

You cannot use PRIV or UNPRIV on a disk device. 



Table 3-25 describes only the errors that can occur during the SET option 
dialogue. For information on other errors that can occur with the SET option, 
refer to Appendix A. 



3.11 Startling Time Sharing 



Use the START option to start the RSTS/E system for normal time sharing. 
The START option allows you to change job and swap maxima, memory 
allocation, and crash dumps. However, any changes made with START 
override the DEFAULT settings for only one time-lsharing session. After that 
time-sharing session, the DEFAULT settings again apply. You can make 
permanent changes in the defaults only by using the DEFAULT option. 

To invoke the START option, type START, ST, or press LINE FEED. 
START or ST causes the initialization code to print the start-up questions 
(which allow you to override DEFAULT parameters) and a list of the disabled 
devices. If you press LINE FEED, the initialization code omits the questions, 
preventing you from overriding any defaults. When you press LINE FEED to 
start the system, the initialization code prints a summary of the system 
defaults, requests the date and time, and then prints the number of disabled 
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devices. The following sample dialogue shows the normal procedure for start- 
ing a RSTS/E SYSGEN system. 

Option: ST 

You cur rent Iv haue: JOB MAK = 2> SWAP MAX = 2BK . 

JOB MAX or SWAP MAX changes? (lf) 

Any (Ti e (ti r >' allocation c h a n d e s ? (lf) 

Y u currently h a i.i e crash d u m p enabled. 

Crash dump? (lf) 

lS-JUN-79? (LF) 

18:^5? (LF) 

D F : disabled - no R F : controller 

DM0: disabled - no RM: controller 

DM1: disabled - no R M : controller 

M T : disabled - no T M : controller 

M T 1 : disabled - no T M : controller 

5 d e I.) i c e s disabled 

? C a n ' t Find file or account 

In the example, the answer to each question is the LINE FEED key. By 
pressing LINE FEED, you accept the parameters you set with the DEFAULT 
option. Accepting the defaults is the normal start-up procedure. You can 
accept the current values for date and time, as well, by pressing LINE FEED. 

After the system accepts your responses, a pause of several seconds occurs. 
During this time, the start-up routines enable all configured terminal inter- 
faces, set up monitor tables, turn on memory management, load the monitor 
and default run-time system, and start the system clock. Finally, the system 
attempts to execute the INIT.BAC system program (described in the RSTS/E 
System Manager's Guide). When you bring up a new system for the first time, 
the INIT.BAC system program is not yet in the system library. As a result, 
the system generates the ?CAN'T FIND FILE OR ACCOUNT error message. 
If the default run-time system is BASIC-PLUS, the 7PR0GRAM LOST - 
SORRY message also appears. The printing of a dot (.) for the SYSGEN 
system or the READY message for the Target system (if its default run-time 
system is BASIC-PLUS) signals the end of the system initialization code 
routines. 

3.11.1 Hardware Messages at Start-Up 

The start-up code checks the system to verify that all configured devices exist 
and that they respond properly. The code disables any device that it cannot 
find or that you have disabled with the SET or HARDWR option. START 
accesses all configured terminal interfaces and disables any that do not 
respond. It activates the memory management unit to determine the size of 
available memory (as in DEFAULT), to load the monitor and default run- 
time system, and to prepare for normal time sharing. START, furthermore, 
loads the stack limit register, enables parity traps for all parity memory, and 
activates the system clock to begin time sharing. If the system does not start 
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as shown in the examples, these components are suspect and should be 
exercised with the standard diagnostics. 

3.11.2 Software Messages at Start-Up 

In addition to hardware checks, START verifies that the required system files 
exist and are of the proper sizes. 

If the file SWAP. SYS does not exist, is not contiguous, or is too small to 
accommodate two jobs of size SWAP MAX, START prints one of the follow- 
ing messages: 

S W A P f S Y S not contiguous or too small 
SN A P * S YS not present in C » 1 3 

If you enabled crash dumps (with either the DEFAULT option or the START 
option), START routines check that the file CRASH. SYS is present in ac- 
count [0,1] on the system disk, is large enough for the current monitor, and is 
contiguous on the disk. If the file does not meet all these conditions, START 
prints one of the following error messages: 

CRASH. SYS does not exist 

CRASH* SYS file of nnn blocKs is not au ail able 

CRASH. SYS is not contiguous 

In the second message, nnn indicates the number of blocks necessary for a 
monitor dump. The error message is followed by the text: 

Crash dump automatically disabled 

If the start-up procedures are successful, proceed to Chapter 4 to generate the 
Target system. 



3.12 Bootstrapping Devices 



The BOOT option, which simulates the hardware ROM bootstraps, allows 
you to bootstrap magnetic tape and disk devices. You can use BOOT to load 
another PDP-11 operating system into memory from disk or tape and to 
reload an altered copy of the initialization code after you have patched it on 
disk. 

To run BOOT, type BOOT or BO in response to the OPTION: prompt. BOOT 
responds by asking for the device to bootstrap. In response, type either the 
device name or press RETURN (for a list of bootable devices) . If the device 
has unit numbers (all devices except DF), you can append the unit number to 
the device name. (If you do not include the unit number in this response, 
BOOT requests it later, with the BOOT UNIT: prompt.) Any unit can be 
bootstrapped. 
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If you press LINE FEED, the system device is bootstrapped. The BOOT 
option automatically determines the system device and unit number, so the 
BOOT UNIT: prompt does not appear. This facility is useful for loading a 
patched version of the initialization code. 

The following example illustrates the use of the option. 

Option: BOOT 

Boot device: DB 
Boot unit: 



RSTS/E i.'7.0 System ttl44 (DBO) 



Option: 

After determining that the specified device exists, BOOT waits for the termi- 
nal to stop printing, then executes a device-dependent routine. It reads the 
device's bootstrap block into location 0, then transfers control to location 0. 

The following table explains the error messages that can appear during the 
BOOT option dialogue. 

Table 3-26: BOOT Dialogue Error Messages 



Message and Meaning 



NOT A MALID BOOT DEMICE 

The device you named is not a valid bootable device or you specified a 
unit number for a DF disk. Press RETURN for a list of devices that can 
be bootstrapped. 

SORRY ♦ BUT THAT DEMICE DOESN'T EXIST 

The device name you typed is valid, but the device does not exist on 
this FDP-11. 



For information on other error messages that appear during use of the BOOT 
option, refer to Appendix A. 



3.13 Loading Stand-Alone Programs 

Use the LOAD option to load and run any stand-alone program from account 
[0,1] on the system disk. You can use LOAD only if the system device is disk. 
The program to be loaded must have the extension .SAV and must not require 
RSTS/E Monitor support. DIGITAL does not supply any stand-alone 
programs. 
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To run LOAD, type LOAD or LO in response to the OPTION: prompt. If you 
press RETURN in answer to the first question, LOAD lists the loadable pro- 
grams. The following is a sample dialogue: 

Option: load 

Load program: STDALN 

STDALN KH 



If the program you specify has an odd transfer address, or if the transfer 
address is greater than the size of the program, LOAD prints the following 
message: 

D d d transfer address? 

If you press RETURN in response to this question, LOAD prints the longer 
message: 

The transfer address of the specified proiSram is odd. 
Please enter a new ( e i.i e n ) transfer address or type 
CONTROL/ C to abort the load. New transfer address? 

The program to be loaded must have an even (word) octal transfer address 
because the PDP-11 traps to an error vector if you specify an odd (byte) 
address. Therefore, type an even address at which the system should start the 
program. 

If you enter a legal transfer address, the system loads the designated program 
into memory and starts execution of it. When execution of the program is 
complete, you can restore RSTS/E by following the appropriate bootstrap 
procedures. 

Error messages that can appear during the LOAD option dialogue are ex- 
plained in Table 3-27. 

Table 3-27: LOAD Dialogue Error Messages 



Message and Meaning 



DIRECTORY ERROR - FILE NOT FOUND 

The directory lookup code in the LOAD option found the file you speci- 
fied, but the file processor code did not. This error indicates a bug in the 
initialization code. You should submit an SPR. 

ILLEGAL PROGRAM NAME 

The program name you typed is in an incorrect format. The name must 
be one to six alphanumeric characters with no embedded spaces. 

PROGRAM NOT FOUND 

The program you specified could not be found. Press RETURN to get a 
list of programs that can be loaded. 



For information on other errors that occur during the use of the LOAD option, 
refer to Appendix A. 
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3,14 Enabling only the Console Terminal 

The UNISYS option provides a way to start the RSTS/E system for time 
sharing without enabling any terminal interfaces except the console (KBO:) 
interface. Use UNISYS as a diagnostic tool in cases where the system will not 
start. If an otherwise nonworking system does work with UNISYS, the termi- 
nal configuration is probably faulty. 

The UNISYS option simply sets a flag that is checked at start-up time. When 
the flag is set, the start-up routines bypass the code that enables terminal 
interfaces. The only way to clear the flag is to reboot the RSTS/E system disk, 
thus reloading the initialization code. (See the description of bootstrapping 
devices in Section 3.12.) Therefore, use UNISYS immediately before starting 
the system. The following example shows the use of the UNISYS option: 

Option: UNISYS 



Option: START 

You currently hai.»e: JOB MAX = 24 » SWAP MAX = IBK. 

JOB MAX or SWAP MAX changes? © 

Any memory allocation changes? © 

Y u currently h a u e crash d u m p enabled* 

Crash dump? (LF) 

20-MAY-79? © 

19:58? © 

All except console terminal b e i n 3 disabled. 

? C a n ' t find file or account 

?Pro^ram lost-Sorry 

Read y 

In the example, you specify the UNISYS and START options. The START 
option asks the usual questions, then prints a message indicating that only the 
console terminal is enabled. 



3.15 Setting Console Terminal Fill Characteristics 

The FILL option sets fill characteristics for the console terminal. Fill charac- 
ters are NULL characters used by each terminal for synchronization delays for 
outputting certain control characters (for example, form feed). The number of 
fill characters vary depending upon the terminal used. The characteristics set 
by FILL are in effect only while the initialization code is running. If the 
initialization code is running from tape, the settings remain only until you 
reboot the initialization code. If the initialization code is running from disk, 
the characteristics remain set when you reboot the initialization code. When 
you start time sharing, however, the characteristics are no longer in effect. 
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To invoke the FILL option, type FILL or FI in response to the OPTION: 
prompt. Valid responses are 0-7 and LA30S. Table 3-27 lists the responses 
recommended for DIGITAL terminals. 

Table 3-28: Recommended Console Terminal Fill Characteristics 



Fill 
Characteristic 


Terminal 




1 

3 

LA30S 


ASR33, KSR33, VT05, LA30, 
VT50, VT52, LA36, VTIOO, 
LA120, LA34, LA38 

ASR35, KSR35 

VT05B 

LA30S 



To set fill characteristics for use during time sharing, use the appropriate 
TTYSET commands in the START.CTL and CRASH.CTL control files. For 
more information on TTYSET and control files, see the RSTS/E System 
Manager's Guide. Refer to the RSTS/E System User's Guide for a discussion 
of fill characters. 

3.16 Invoking SAVE/RESTORE while Running INIT 

The SAVE/RESTORE system program is a disk volume backup and copy 
utility that provides you with four operational functions: SAVE, RESTORE, 
IMAGE, and IDENTIFY. These four functions are defined as follows: 



{ 



1. SAVE 



2. RESTORE 
[3^ IMAGE 
\jt. IDENTIFY 



Creates a copy of a RSTS/E file-structured disk. The SAVE function 
backs up an entire disk volume to disk or magnetic tape. The tape(s) or 
disk(s) created by SAVE operations is (are) called a SAVE Set. 

Recreates a RSTS/E file-structured disk from a SAVE Set. 

Copies an entire RSTS/E file-structured disk to a LIKE disk. 

Prints label information and other volume characteristics of a SAVE Set 
volume or a RSTS/E file-strucutred disk. 



You invoke the SAVE/RESTORE program off-line while you are running the 
system initialization code (INIT.SYS). In response to the INIT OPTION: 
prompt, type SAVRES on the console terminal. After you press RETURN, 
SAVE/RESTORE requests the current date and time, then prints its own 
prompt, SAV/RES FUNCTION:. The example that follows illustrates the 
proper response to the OPTION: prompt and the appearance of the 
SAVE/RESTORE program prompt. 

Option: SAUREB 

DD~MMM~YY ? 12-MAY-73 
HHsMM ? 12:15 

SAM /RES Function: 
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As soon as the SAV/RES FUNCTION: prompt appears you are under the 
control of SAVE/RESTORE and are ready for volume backup processing. If 
you want to perform a SAVE, RESTORE, IMAGE, or IDENTIFY operation, 
type one of these functions in response to the SAV/RES FUNCTION: prompt. 
The program responds by printing a set of dialogue questions (IDENTIFY 
asks only one). For a description of the SAVE/RESTORE program refer to the 
RSTS/E System Manager's Guide which includes an explanation of the dial- 
ogues of all four operations and any error messages that might occur during 
SAVE/RESTORE operations. Also provided in that documentation is a de- 
scription of how to boot from a SAVE Set (and RSTS/E volume) and what 
SAVE/RESTORE operations you can legally perform once you have booted 
from that medium. Finally, it is strongly recommended that you use the 
SAVE/RESTORE program to make a copy of the disk you create as a result of 
the system generation process (Step 37). 
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Chapter 4 

Generating the Target System 



After tailoring the SYSGEN system, your next step in the system generation 
procedure is generating the Target system. The generation of the Target 
system involves 1) running the program CREATE. SAV, 2) answering the 
system configuration questions, 3) running the program SYSBAT.SAV, and 
4) shutting down the SYSGEN system. 

The program CREATE. SAV includes a batch stream that copies the required 
files to the SYSGEN disk. These files are used in generating the RSTS/E 
Monitor and BASIC-PLUS Run-Time System. After copying the files, 
CREATE. SAV chains to the SYSGEN program, which asks the configuration 
questions. 

Your answers to the configuration questions establish the hardware devices 
and optional software elements that the Target system will support. 

After answering the configuration questions, run the SYSBAT.SAV program. 
SYSBAT.SAV runs a batch file containing commands that cause the assem- 
bling of the monitor, terminal service, device drivers and system tables and 
the linking of the Target system monitor and BASIC-PLUS Run-Time 
System. If you requested patching during the SYSGEN dialogue, the batch 
file also contains commands that initiate the patching procedure. When exe- 
cution of SYSBAT.SAV is complete, shut down the SYSGEN system and 
proceed to Chapter 5 to tailor the Target system. 

NOTE 

All filename extensions in this chapter are .SAV, unless stated 
otherwise. 
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4.1 Running the Program CREATE. SAV 

The program CREATE. SAV includes a batch stream that enables logins and 
copies the files needed for Target system generation to the SYSGEN disk. 
CREATE. SAV then chains to the SYSGEN dialogue program, which asks the 
configuration questions. 

If your distribution medium is disk cartridge, logically mount it before run- 
ning CREATE. SAV. Ensure that the disk drive is write protected. Use a 
command of the following form: 

.MOUNT dey :SYSGNG/RO 

where dev represents the device name (DK, DL, or DM) and unit number of 
the disk where the distribution disk cartridge is mounted. The /RO switch 
mounts the disk for read access only to prevent accidental destruction of data 
on the disk. 

Start the execution of CREATE. SAV by typing the following command: 

.R id e I.) : CREATE. SAM 

where dev represents the device name and unit number of the distribution 
medium. The program first enables logins for the SYSGEN system. Then, 
it copies the LOGIN. SAV program from the distribution medium to the 
SYSGEN disk. Finally, it logs in on a pseudo keyboard under account [1,2] 
and uses PIP to copy the following files to the SYSGEN disk from the distri- 
bution medium: 

LOGIN 

LOGOUT 

PIP 

UTILTY 

MACRO 

CREF 

LINK 

SILUS 

HOOK 

SYSGEN 

SYSBAT 

ONLPAT 

ERR.STB 

PIPSAV.TXT 

TECO.RTS 

TECO.TEC 

MINCOP.BAS 

The programs LOGIN, LOGOUT, and UTILTY are special versions of system 
programs that run under the RTll Run-Time System and are necessary for 
system generation. DIGITAL supplies only one version of the PIP program 
which runs under the RTll Run-Time System and is also necessary for system 
generation. 
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The files MACRO, CREF, LINK, SILUS, HOOK, and ERR.STB are used 
later in the actual generation of the RSTS/E Monitor and BASIC-PLUS Run- 
Time System. MACRO assembles TBL, TTDINT, and TTDVR, which are 
the system table and terminal service modules. All other system modules are 
assembled by DIGITAL before they are shipped. CREF generates the cross 
reference table that appears at the end of each assembly listing. LINK links 
modules of both the RSTS/E Monitor and the BASIC-PLUS Run-Time Sys- 
tem. SILUS creates Save Image Library files. HOOK makes the disk or tape 
that is output from the system generation process capable of being 
bootstrapped. ERR.STB defines the error symbols for the monitor and run- 
time system links. ONLPAT allows installation and verification of patches to 
RSTS/E system code. 

SYS GEN asks the configuration questions. 

SYSBAT is the program which, later in the generation process, interprets a 
batch file containing commands that run the preceding programs in order to 
generate the monitor and/or BASIC-PLUS Run-Time System. 

CREATE.SAV generates a log file, named CREATE.LOG, on the system disk 
under the logged in account (normally [1,2]). In addition, it prints all the 
pseudo keyboard input and output on the console terminal (KBO:), indented 
two spaces from the left margin. 

After CREATE.SAV copies all the necessary files, it logically dismounts the 
distribution disk (if the distribution medium is disk) and chains to the 
SYSGEN dialogue program. 



4.2 Answering System Configuration Questions 

The SYSGEN dialogue program automatically suggests answers to the config- 
uration questions by printing a response (RES) in one of the three forms 
shown in Table 4-1. 



Table 4-1: Automatic Answer Formats 



Answer 


Reason 


*RES* 


The program has ascertained that RES is the correct response. 


#RES# 


The program assumes that RES is the correct response. 


#m 


The program does not know and cannot guess the correct response. 



To accept the automatic answer, press LINE FEED. To override the auto- 
matic answer, type a response followed by the RETURN key. To obtain an 
explanatory form of the question, press only RETURN. If you need to return 
to an earlier question, press ESC (shown as ALT MODE on some terminals). 
Table 4-2 summarizes the possible responses to a configuration question. 



Generating the Target System 4-3 



Table 4-2: Possible Responses to Configuration Questions 



Response 



Meaning 



<string> 



<string> is the desired answer. 

Print the long, explanatory form of the question. 

Accept the automatic answer for the question. 
Not valid if the automatic answer is #??j^. 

Return to the preceding question or to the first question in this sequence. 



By using the ESC key, you can return to the previous question or to an earlier 
question in the current sequence. For example, pressing ESC in response to 
the RK05'S question returns you to the previous question, RS03/RS04'S. 
Within a sequence of questions, ESC causes a return to the first question in 
the sequence. As an example, pressing ESC in response to the DATASET 
SUPPORT FOR DHll'S question will return you to the DHll'S question. 
You cannot back up beyond certain configuration questions, which delimit 
sections of the configuration dialogue. These questions are as follows: 

KLl 1 » LCll f DLllA f DLi IB 'S? 

RF/RSl 1 's? 

TUlG/TElG/TEa5/TU77 'S? 

RK01/RX02 'S? 

LARGE FILES? 

RESIDENT SIMPLE SYS CALLS? 

FPP? 

If you press ESC in response to any of the listed questions, the SYSGEN 
dialogue program reprints the question. 

The SYSGEN program uses the responses to the configuration questions to 
create a batch file, SYSGEN. CTL. If you are generating a monitor, the file 
CONFIG. MAC is also created. CONFIG. MAC defines assembly parameters 
for the Target monitor. The SYSBAT program uses the SYSGEN.CTL file to 
perform the requested generation. The remainder of this section describes the 
configuration questions in detail. 



4.2.1 Preliminary Considerations 

The system can print the configuration questions in either a short form or a 
long form. The short form questions are merely a brief prompt. The long form 
questions include helpful information. If you specify the short form questions, 
you can request the long form for any question by pressing RETURN in 
response to the short form prompt. 

You can generate RSTS/E for the computer on which you are working or for 
another computer. If you specify that you are generating RSTS/E for another 
computer, the SYSGEN program prints #??^ for all hardware automatic an- 
swers because it cannot perform hardware checks to ascertain the answers. 
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You must specify the distribution medium on which you received the RSTS/E 
kit. The automatic answer to the DISTRIBUTION MEDIUM question is ?^??# 
unless you began the dialogue by running CREATE. SAV. Answer by typing 
the device name of the distribution medium (MM, MS, MT, DK, DL, or 
DM). Remember that the device names MM, MS, and MT are not equivalent 
on the SYS GEN system. If the system generation files are on the current disk 
(e.g., if you are generating RSTS/E on-line), type SY to specify the system 
disk. 

The generated system can be output to the SYSGEN disk, another disk, or 
magnetic tape. DIGITAL recommends that the SYSGEN disk be the output 
medium only if that disk is a DM, DP, DR, or DB type disk. If the output 
medium is a small disk (RK05, RLOl, RL02), the generated system should be 
output to a new disk or tape. The system initialization code, error message 
file, generated monitor SIL file, generated run-time system file, RTll.RTS, 
PIP.SAV and ONLPAT.SAV are written on an output disk. An output mag- 
netic tape receives the four system files, all load maps, and the listing files. 
Other files are written out if you answer YES to the RSX AS DEFAULT RTS 
question. The automatic answer to the OUTPUT MEDIUM question is SY if 
the SYSGEN disk is large. Otherwise, the automatic answer is the same as 
the specified distribution medium. 

NOTE 

The SYSGEN system supports four RK05 drives and only two 
of each other disk type and two of each type tape. If you plan to 
use a fixed disk unit not supported by SYSGEN for the Target 
system disk, you must use an intermediate medium (such as 
magnetic tape) for output of the Target system. You can later 
(as described in Chapter 5) copy the Target system files to the 
final disk. 

If you specify a disk as the output medium, the SYSGEN program prints the 
PACK ID question. Type the pack ID you specified when you initialized the 
output disk. 

The system generation process creates files (programs with extensions of 
.OBJ, .LST, .SAV, and .STB) on the SYSGEN disk. If you need to conserve 
space on this disk, these files can be deleted after they are used. To delete the 
system generation files, answer YES to the DELETE FILES question. To 
retain the files, answer NO. If you type N, you will be able to perform an on- 
line system generation, using SY: as your distribution medium. Type Y and 
some of the files needed to perform an on-line system generation will be 
deleted. You will then not be able to perform an on-line generation unless you 
again mount the distribution medium. On small disks (e.g., RFll), the sys- 
tem generation process will not finish unless you delete the files. 

System generation creates load maps and (during RSTS/E Monitor genera- 
tion) assembly listing files. These files are unique for each system and contain 
valuable information for system documentation and maintenance. If a line 
printer is available during system generation, answer YES to the LP FOR 
SYSGEN question. The load maps will be printed automatically and you can 
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request (in response to a later question) the printing of the assembly listings. 
If you answer NO to this question, none of the load maps or listings can be 
printed during system generation. If the answer to DELETE FILES is YES, 
but a line printer is not available, the load maps are not deleted from the 
SYS(SEN disk. 

The SYSGEN program allows you to generate an entire RSTS/E system, 
including monitor and BASIC-PLUS Run-Time System; only a monitor; or 
only the BASIC-PLUS Run-Time System. In addition, you can name both 
the RSTS/E Monitor SIL and the BASIC-PLUS Run-Time System with any 
name you prefer. The name must be one to six alphanumeric characters. The 
default names for the RSTS/E Monitor SIL and BASIC-PLUS Run-Time 
System are RSTS and BASIC, respectively. If you generate additional 
RSTS/E Monitors or BASIC-PLUS Run-Time Systems later, remember to 
assign different names to the new files. 

4.2.2 Patching Monitor and BASIC-PLUS Code 

The RSTS/E system contains a program, ONLPAT, which you can use to 
patch system code, or programs you have created. The functions of ONLPAT 
are described in the RSTS/E System Manager's Guide. 

The SYSGEN program allows you to include patching with ONLPAT. There 
is one set of questions for monitor patching and one set of questions 
for BASIC-PLUS Run-Time System patching. If you include either, the 
SYSBAT program will provide messages telling you when to mount the device 
on which your patch files reside. 

4.2.3 RSX or BASIC-PLUS-2 as the System Default Run-Time 
System 

If you plan to install RSX or BASIC-PLUS-2 as your system default run-time 
system, you must type YES in response to the RSX AS DEFAULT RTS 
configuration question; otherwise, type NO. The YES response instructs the 
system to copy to the Target disk the RSX.RTS Run-Time System and the 
tasks necessary to build the remaining libraries. 

If you do not generally use the BASIC-PLUS Run-Time System, it may be 
more beneficial to install RSX rather than BASIC-PLUS as your system 
default run-time system. Since the RSX Run-Time System requires only 3K 
words of memory in contrast to 14K words (minimum) for BASIC-PLUS, you 
can save at least UK words of memory by installing the smaller run-time 
system. 

4.2.4 Terminal Devices and Software 

A RSTS/E system can handle a maximum of 128 terminals including at least 
one pseudo keyboard. An installation can have any combination of local and 
remote line interfaces as long as the total number of terminal lines and pseudo 
keyboards does not exceed 128. 
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RSTS/E assigns each terminal a keyboard number ranging from to 127. The 
system assigns keyboard number to the console terminal and refers to the 
console terminal by the device designator KBO:. The type of line interface 
that connects a terminal (other than the console terminal) to the system 
establishes its keyboard number. The keyboard number associated with each 
line is important because you must use it as a basis for specifying the terminal 
speeds allowed on each of the variable speed lines on the system. (See the 
description of the TTYSET.SPD file in the RSTS/E System Manager's 
Guide.) 

RSTS/E assigns keyboard numbers in the following order: the system console 
terminal; all KLll, LCll, DLllA, and DLllB lines; DCll (remote dial); 
DLllC and DLllD lines; DLllE (remote dial); PK (pseudo keyboards); DJll 
lines; and DHll and DZll lines in increasing order of unit number and 
increasing order of configured lines within each unit. 

4.2.4.1 Terminal interfaces — The answers to the configuration questions 
concerning the number of each type of terminal interface must accurately 
reflect the hardware configuration. For example, DLllC and DLllD inter- 
faces are similar in construction and operation to the DLllA and DLllB 
interfaces. However, the interfaces have different ranges of UNIBUS addresses. 
Because of this similarity, new installations often have problems with im- 
proper configuration of the terminal interfaces. You should rely on the auto- 
matic answers to verify the terminal interface configuration. 

SYSGEN requests the number of lines to enable for each DJll, DHll, and 
DZll multiplexer unit on the system. Each DJll or DHll multiplexer unit 
has 16 lines. Each DZll multiplexer unit has 8 lines. You need not enable 
every line on a DJll, DHll, or DZll. Therefore, RSTS/E can be configured 
for fewer than the maximum number of lines physically present on each 
multiplexer unit. Enable fewer than the maximum number of lines for a 
multiplexer unit when you need to conserve memory or when enabling all the 
lines would exceed the limit of 128 lines. For example, if six DHll and four 
DZll units are present, you can enable at most 126 of the 128 possible lines 
(because of the console terminal, which is always on a single-line interface and 
because at least one pseudo keyboard is always generated). If N lines (where 
N is less than 16) are enabled on a DHll or DJll, the lines numbered N 
through 15 on the unit are not enabled. Lines not enabled are not available for 
use and are treated as nonexistent. Thus, if you enable five lines on a DZll, 
lines through 4 are operational and lines 5 through 7 on that DZll cannot be 
used unless the system is regenerated. 

Generate all multiplexer lines into monitor during system generation so that 
they can be utilized later without regenerating the system. The configuration 
questions do not ask you to specify which enabled multiplexer lines are actu- 
ally to be used or which lines are to have modem control enabled (if modems 
are configured). The SET initialization options allow you to temporarily en- 
able or disable any keyboard line and to enable or disable modem control. 

DHll and DZll multiplexers can support automatic answer data sets. A 
DMll-BB connects a DHll to an automatic answer data set. If your system 



Generating the Target System 4-7 



includes one or more DHll multiplexers and DMll-BB modem control multi- 
plexers, you can include support for automatic answer data sets on the 
DHlls. DZll-A and DZll-B units include partial modem control, but 
DZll-C and DZll-D units do not. If your system includes DZll-A or 
DZll-B units, you can include support for automatic answer data sets on the 
DZlls. 

4.2.4.2 Pseudo Keyboards — You can configure as many as 127 pseudo key- 
boards into the system. At least one pseudo keyboard is generated automati- 
cally into all systems. Each copy of the BATCH program requires one pseudo 
keyboard to run user jobs. If you plan to run several copies of BATCH simul- 
taneously, specify at least one pseudo keyboard for each copy of BATCH. One 
additional pseudo keyboard is necessary for each application that will use the 
pseudo keyboard features described in the RSTS/E Programming Manual. 

NOTE 

RSTS/E permits a maximum total of 128 single line interfaces, 
enabled multiplexer lines, and pseudo keyboards. (The console 
keyboard is always enabled.) If you configure more than 128 
lines and pseudo keyboards, the SYSGEN program prints an 
error message after the pseudo keyboard question and repeats 
all the terminal interface questions. 



4.2.4.3 2741 Terminals — RSTS/E supports 2741-compatible terminals con- 
nected to DLllD, DLllE, and DCll single line interfaces and to DHll and 
DZll multiplexers. 2741 terminals normally use the RS232 EIA standard 
connection; hence, they can be connected locally to the computer through null 
modems to any of the preceding interfaces. They can also be connected 
through data sets or acoustic couplers for operation over telephone lines. You 
can include 2741 support on any combination of single line interfaces (DLllD, 
DLllE, and DCll) and multiplexers (DHll and DZll). 

NOTE 

To function properly on a RSTS/E system, a 2741-type termi- 
nal must have the Transmit Interrupt feature, the Receive 
Interrupt feature, and the ATTN (or BREAK) key. These 
features allow the terminal to recognize a reverse break signal 
from the computer, lock its keyboard, and enter receive mode. 
Manufacturers of 2741 type terminals usually provide these as 
standard features but a few offer them as optional at extra cost. 

RSTS/E supports four code and keyboard arrangements for 2741 terminals: 
IBM Correspondence Code (CORR), Extended Binary Coded Decimal 
(EBCD), Standard Binary Coded Decimal (SBCD), and Call 360 BASIC Code 
(C360). The code and keyboard arrangements are described in the RSTS/E 
System User's Guide. You must define the code(s) your system should support 
so that the terminal service module can include them. You can specify any 
combination of the four supported codes. 
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If you configure more than one code, the terminal service includes a facility 
that enables a user at a 2741 terminal to change codes (the procedure for 
changing codes is described in the RSTS/E System User's Guide). The first 
code you name in response to the 2741 CODE(S) question becomes the system 
default. For example, if your system will support both Correspondence and 
EBCD 2741 terminals, but you prefer EBCD as the default, type EBCD, 
CORK in response to the 2741 CODE(S) question. 

4.2.4.4 Multiple Terminal Service — The multiple terminal service option 
allows one program to interact simultaneously with several terminals on one 
I/O channel. A program can control several keyboards by establishing a mas- 
ter keyboard on a single channel and by assigning various other keyboards as 
slave terminals. To perform input or output, the program executes Record I/O 
statements on that single channel. It uses special software options to ascertain 
the keyboard being serviced. In addition, the system can automatically stall 
program execution in the absence of keyboard input. The system can then 
make the program eligible to run when keyboard input is pending from the 
master keyboard or from one of its slaves. Thus, a single program can interac- 
tively service low volume keyboard input and output associated with several 
stations. This facility eliminates the need to run separate copies of the same 
program at each terminal when several terminals must perform a similar 
function. Multiple terminal service is explained in detail in the RSTS/E 
Programming Manual. 

4.2.4.5 Echo Control — The echo control option allows a full duplex terminal 
to simulate block mode operation. A program can define fixed-length fields for 
user input and accept input from only one field at a time. Echo control also 
enables a program to define special characters for character deletion 
sequences within a field. Echo control is useful for data entry and other 
applications in which the programmer needs to control the appearance of 
terminal output. A complete description of the echo control facility is pre- 
sented in the RSTS/E Programming Manual. 

4.2.5 Disk Devices 

Disks in the RSTS/E system operate in either the public structure or as 
private disks. The disk that contains the system accounts and executable code 
of RSTS/E is called the system disk and is the first disk in the public struc- 
ture. All other disks in the system are referred to collectively as nonsystem 
disks. 

A removable system disk is more practical on a RSTS/E system than a fixed 
system disk. A removable cartridge or pack can be taken from the computer 
area when the system is not operating and kept in a safe place to reduce the 
chances of inadvertent or malicious destruction. To provide the same level of 
security with a non-removable disk you must copy the contents to a secondary 
medium each time you shut down the system. 

If the system requires a large amount of public storage space, a single, large- 
capacity disk pack drive is preferable to multiple RK05, RK05F, RLOl, RL02 
or RK06 DECpack disk drives. Each time a file is created within the public 
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structure, the system searches the directories of each pubUc disk to ensure 
that a file of the same name does not already exist. The use of multiple disks 
in the public structure increases the overhead required for such a search. You 
can use private disks rather than public disks as a method of reducing over- 
head on systems with multiple disk drives. 

An RK05F moving head fixed disk is basically two RKOS's with one set of read 
heads. It has twice the capacity of a single RK05, and provides increased 
capability at lower cost than multiple RKOSs. Unit designations for each 
RK05F are an even-odd pair (e.g., 2 and 3, 4 and 5). You must initialize and 
format each half of the disk separately. An RK05F can be assigned 
unit designations of and 1 and can be used as the system disk. However, 
DIGITAL recommends for security purposes that the system disk be a remov- 
able cartridge. Therefore, you can most effectively use an RK05F as a nonsys- 
tem disk. 

You can obtain optimum performance if the system is configured with a 
removable, moving head disk and a fixed head disk. With such a configura- 
tion, the monitor can swap user jobs out of memory onto the faster fixed head 
disk.* Disk accessing operations on the moving head system device can then 
be confined to manipulating user files and directories while the faster fixed 
head device takes on the burden of moving user jobs into and out of memory. 
In such a case, the fixed head disk need not contain valuable system data. At 
the start of time-sharing operations, you can install swapping areas on the 
fixed head disk. 

All moving head disk controllers allow several drives to perform seek opera- 
tions simultaneously. Since the controller is not busy during seek operations, 
data transfers on one drive can overlap seeks in progress on other drives. If 
more than one drive is on the same controller, you can configure an over- 
lapped seek driver to accelerate processing for the disks on that controller. 
The overlapped seek drivers, however, require more memory than the 
nonoverlapped seek drivers. The overlapped seek drivers provide advantages 
in throughput that normally outweigh the disadvantages of the additional 
memory required. Therefore, DIGITAL recommends the overlapped seek driv- 
ers for all systems with more than one disk drive on a single controller. The 
only exception to this recommendation is a system that includes a single 
RK05F disk and no RK05 disks. Because the RK05F disk has only one set of 
read heads for the even-odd unit pair, no overlapping can take place. You 
should configure the nonoverlapped seek driver for that disk device. 

4.2.6 Other Peripheral Devices 

The use of peripheral devices on the RSTS/E system reduces the burden of 
storage requirements on the disks and provides convenient media for file 
archives. You can store infrequently used program and data files on magnetic 
tape (DECtape or industry standard magnetic tape), paper tape, and disk- 
ette. You can access the files readily when necessary. The paper tape reader 

*The RM03 disk, though a moving head disk, is by virtue of its higher data transfer rate a good 
alternative to a fixed head disk for swapping. Because of its storage capacity (67 milHon 
bytes), only a small fraction of an RM03 disk pack (at most 4 million bytes) is needed for 
swapping, and it should be a file structured disk. The rest of the pack can be used for data 
storage. 
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and card reader provide convenient methods of input. You can improve the 
production of hard copy output on the RSTS/E system by using multiple line 
printers with different characteristics. 

If the RSTS/E system has a card reader, configure one of the four following 
card codes: ANSI standard, DEC029, DEC026, or IBM 1401. Refer to the 
RSTS/E Programming Manual for these card codes. The default card code is 

ANSI. 



4.2.7 DECnet/E Network Support 

DECnet/E is the DIGITAL network package for RSTS/E. DECnet/E allows 
user jobs to communicate with other DECnet systems in the network. The 
DECnet/E documentation describes in detail the concepts and capabilities of 
DECnet/E. The RSTS/E Programming Manual describes local communica- 
tions. DECnet/E software is not included in the standard RSTS/E distribu- 
tion kit but is licensed as a separate product. If your system includes 
DECnet/E, you must respond Y to the DECNET NETWORK SUPPORT 
question, then specify the medium on which you received the DECnet/E kit 
after the DECNET DISTRIBUTION MEDIUM question. 

For network operation, the system must include at least one DMCll interpro- 
cessor link. RSTS/E supports up to 16 DMClls. 

Messages printed during SYSBAT processing tell you when to mount the 
medium containing the DECnet/E software. 



4.2.8 The KMC-11 Micro-Processor 

The KMC-11 is a micro-processor that can be attached to the UNIBUS of the 
PDP-11 computer system. The KMC-11 will run asynchronously with the 
PDP-11 CPU. When the KMC-11 is running, as for example to handle 3271 
Protocol Emulation, it will provide Non-Processor Request data transfers and 
greatly reduce PDP-11 CPU overhead by eliminating almost all Binary Sys- 
chronous Communication character interrupts and protocol processing. IBM 
Protocol Emulator products also use XBUF rather than small buffers. 



4.2.9 Extended Buffering for LP 

If the EXTENDED BUFFERING FOR LP question is answered YES, the line 
printer driver will be able to buffer data in XBUF as well as in small buffers. 
Each line printer driver will use a maximum of 2.5K words of XBUF while it 
is running. In addition, the driver is approximately 70 words longer. 

This option is intended for installations with large systems that want to im- 
prove line printer performance and reduce line printer impact on the small 
buffer pool. It is not recommended for systems with less than lOK words of 
XBUF. This is important because use of XBUF by the line printer driver will 
significantly reduce the hit rate for directory caching on small systems. 
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4.2.10 RSTS/E to IBM Mainframe Communications Support 

4.2.1 0.1 RSTS/E 3271 Protocol Emulator — The RSTS/3271 Protocol Emulator 
allows user tasks running under RSTS/E to communicate interactively with 
application programs running on an IBM System/370 or IBM Series/30 
System. RSTS/E requires that the IBM programs run under the IMS/VS or 
CICS/VS DB/DC systems. With the RSTS/E Protocol Emulator package you 
can have on-line entry, retrieval, update, and file transfer access to IBM files. 
Note that the RSTS/3271 software is not included in the standard RSTS/E 
distribution kit but is licensed as a separate product. 

The communications discipline used by the RSTS/3271 Protocol Emulator is 
the 3271 subset of IBM's Binary Synchronous Communications (BSC) proto- 
col using EBCDIC code. This subset of BSC supports operation of full and 
half-duplex leased lines in either point-to-point or multipoint configurations 
at transmission speeds up to 9600 bits per second. The emulator does not 
support switched facilities, contention line control, or transparent BSC capa- 
bility, but it can share a multidrop line with control units functioning in 
transparent or non-transparent mode. 

By using the KMCll micro-processor the RSTS/3271 Protocol Emulator can 
lower significantly the CPU overhead associated with BSC communications. 
To provide this benefit, the KMCll handles all modem and Hne control, BSC 
protocol, and does ASCII/EBCDIC code conversion in both directions. 

In summary, the RSTS/3271 Protocol Emulator can: 

1. permit RSTS/E tasks to communicate interactively with IBM tasks, 

2. talk to IMS/VS, 

3. talk to CICS/VS, and 

4. support the IBM 3271 interactive BSC protocol. 

For a detailed discussion of the RSTS/E 3271 Protocol Emulator, refer to the 
RSTS/3271 Protocol Emulator User's Guide. 

4.2.10.2 RSTS/2780 Emulator Package —The RSTS/2780 Emulator Package 
allows RSTS/E to emulate the operation of an IBM 2780 Remote Batch Ter- 
minal. The operations emulated permit communication between RSTS/E and 
an IBM system or between two RSTS/E 2780 configurations. Transmission of 
data can originate from a card reader or disk files. Received data can be 
directed to a line printer or to disk files. All data is transmitted in EBCDIC or 
binary code, and communication is supported over synchronous, point-to- 
point contention mode only, at up to 4800 baud. RSTS/E 2780 also supports a 
spooling operation which allows RSTS/E users to queue files for transmission. 

The RSTS/2780 User's Guide describes the features of the 2780 package. The 
RSTS/2780 software is not included in the standard RSTS/E distribution kit, 
but is licensed as a separate product. Messages printed during system genera- 
tion tell you when to mount the tape or disk containing the RSTS/2780 soft- 
ware. The 2780 package requires the KGllA communications arithmetic unit 
and a DPll, DUll, or DUPll synchronous line interface unit. 



4-12 Generating the Target System 



4.2.11 System Capacity and Optional Features 

4.2.11.1 Large Files — Your installation may need to create and process files 
which are larger than 65535 blocks. The Large File feature which you can add 
to your system during system generation provides this capability. If you have 
a large file requirement, you must include this feature in your monitor. How- 
ever, even if you do not intend to create files larger than the 65535 block limit, 
you can significantly improve your system's throughput by selecting this 
option. 

The version of FIP that supports large files retains directory information in 
memory in buffer areas called File Control Blocks (FCB) and Window Control 
Blocks (WCB). These areas retain pointers to directory blocks on disk and to 
blocks that are being accessed. Since the large file processor keeps more 
directory information in memory than is possible without using the large file 
processor, you can reduce the amount of directory I/O required to do window 
turning by including the large file code in your monitor. In addition, because 
the FCB and WCB buffers are interconnected, you can reduce the amount of 
directory I/O necessary to open a file which is already open. When a file is 
opened and information is requested from disk, the large file processor first 
checks the buffer areas in memory to see if the buffers contain any block 
information needed by the recently opened file. Since it is significantly faster 
to scan these buffers in memory than it is to perform a disk I/O, you decrease 
directory search time and consequently the load on your disk I/O drivers. 

Additional features of this option are: 

1., reduces the processing time of interlocked block checking for files opened 
in update mode, 

2. able to extend files opened in update mode (for shared write access) while 
they remain open, and 

3. provides accurate file sizes. 

Unless it is more important to minimize the size of permanently resident 
memory in your monitor than to process disk information more efficiently, 
you should include the Large File feature on your system. 



4.2.11.2 Maximum Number of Jobs — With sufficient hardware, RSTS/E can 
handle up to 63 simultaneous jobs. You must specify a maximum number of 
jobs (the configured job maximum) at system generation time because this 
value determines the size of several monitor tables. You can set a lower 
maximum (the default job maximum) later when you set the system defaults. 
You cannot increase the configured job maximum without regenerating the 
RSTS/E Monitor. 

The maximum number of jobs that can be run efficiently depends on the 
memory space available and the number and types of disks on the system. 
Memory space requirements are described in Appendix B. To calculate the 
effect of disk devices, see Section 3.8.1.1, which describes swapping files. 
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4.2.11.3 Small Buffers — The RSTS/E system handles characters, data 
transfers, queued interjob messages, and file processing requests by using 
intermediate memory storage, called small buffers. Small buffers are 16-word 
storage units in the monitor part of memory. These buffers are a system 
resource. You must configure a sufficient number of them at system genera- 
tion time. If you do not configure enough small buffers, jobs can become 
stalled because too few small buffers are available. Jobs must wait until 
enough buffers are freed by other jobs currently claiming them. 

The number of small buffers needed at any one time depends on the dynamic 
requirements of the jobs on the system. The automatic answer printed by the 
configuration question is computed as 9 for each configured job, plus 80. This 
number is sufficient for most systems. Thus, for a typical 10-job system, you 
should configure 170 ((9*10) +80) small buffers. 

For planning purposes, consider the following guidelines. Each active termi- 
nal requires four or five small buffers for normal input and output operations, 
and several more for echo control operations. Each job requires four small 
buffers for descriptive information about the job. Therefore, a system running 
10 jobs and using 8 terminals needs 72 to 80 small buffers. 

Next, consider the types of processing done on a typical system. Each file 
opened by a job requires one small buffer, plus 1 additional for each channel 
on which it is open on a system which supports files larger than 65535 blocks. 
If each of 10 jobs opens 3 disk files, RSTS/E needs 30 to 60 more small buffers. 
If all jobs open the maximum of 15 files simultaneously, 150 to 300 small 
buffers are necessary. On a typical system, the 3-file situation is more likely, 
so 30 more small buffers must be added for a running total of 102 to 110. On a 
system supporting large files, you need to add 1 more small buffer for each 
distinct file being open. 

RSTS/E also uses small buffers for certain transient operations. The system 
uses one small buffer for each disk transfer queued by the monitor and one 
small buffer for each job that is installed as a message receiver. Many system 
programs, including QUEMAN, QUE, ERRCPY, BATCH, SPOOL, and 
OPSER, communicate through the send/receive system function calls. These 
system function calls claim at least one small buffer for each message queued 
for a receiving job. Normally, these operations use small buffers for short time 
periods (fractions of a second). A reasonable number of small buffers to allo- 
cate for such operations on the 10-job, 8-terminal system is approximately 35 
small buffers, bringing the total to 127 to 135. 

Unless the send/receive code can use extended buffer space (see Section 
3.8.4.7), each pending message occupies small buffer space. The number of 
messages that the system can hold in the small buffer pool depends on the size 
of the messages and the speed with which the receiving job processes them. 
The following equation gives the number of small buffers (N) needed to 
process a message. 

_ length of message in bytes + 8 ^ ^ 
32 
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By substituting the correct value for the length of a message, performing the 
calculation, and rounding N up to the next integer, you can compute the 
number of small buffers needed to process any message. By using the equa- 
tion, you can determine, for example, that a 512-byte message requires 18 
small buffers. The size of the messages and the amount of message processing 
(m the system affect the availability of small buffers. If the system processes 
.many messages, you can improve system performance by allocating space to 
extended buffers. 

Character-oriented output devices use small buffers to hold data awaiting 
output. These devices (line printer, terminal, and paper tape punch) have 
buffer quotas. A buffer quota is the number of small buffers a device should 
obtain for reasonable efficiency. The buffer quotas are 20 for a line printer, 10 
for a terminal, and 10 for a paper tape punch. The sample system thus needs 
an extra 20 small buffers for one line printer. The running total is now 157 to 
165 small buffers for an 8-terminal, 10 job system. 

RSTS/E also uses small buffers for CCL commands and run-time systems. 
Each defined CCL command requires one small buffer. Auxiliary run-time 
systems (not the system default) that you add to the system with the UTILTY 
program also require one small buffer each. If the sample system has 10 CCL 
commands and 1 auxiliary run-time system, add another 11 small buffers to 
make the total 168 to 176. 

The total requirement for an 8-terminal, 10-job system is approximately 170 
small buffers, allowing for idle terminals and occasional system slowdown. 
Except for periods of heavy keyboard and message activity, enough free small 
buffers will be available to maintain good system throughput. 

You can monitor system performance by observing the number of free small 
buffers available, as reported by the SYSTAT program. For good system 
performance, the monitor does not allow the number of free small buffers to 
drop below 40. 

4.2.11.4 System-Wide Logical Name Assignments — RSTS/E allows you to 
assign up to 50 logical names on a system-wide basis. Any user can type a 
system-wide logical name to access the device and account it represents. Each 
logical name assignment requires five words of monitor table space; therefore, 
you should not configure more logical assignments than your system will use. 
Refer to the RSTS/E Programming Manual or the RSTS/E System Manager's 
Guide for further information on system- wide logical names. 

4.2.11.5 l\/lonitor Statistics Gatliering Package — The optional Monitor 
Statistics Gathering Package includes tables that record job, disk, and direc- 
tory cache statistics. If you include the package during system generation, the 
code and buffer space will be added to the monitor SIL. 

This code is a fully supported part of the monitor; inclusion of this code does 
not invalidate support for your RSTS/E system. However, the use of this 
optional feature is an unsupported activity, unless such support is provided 
for in a DIGITAL Software Services consulation contract. Note also that this 
feature may change in future releases with respect to what data is accumu- 
lated and how the data is accessed. 
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4.2.11.6 File Processor Buffering — The optional file processor (FIP) buffer- 
ing module accelerates file processing on the RSTS/E system. The module 
reduces the number of accesses to disk by maintaining more than one disk 
directory block in memory. The FIP buffering process improves the perform- 
ance of system operations that involve accessing of disk directories because 
the related data are accessed in memory that is used as a cache. The following 
are representative operations that involve directory accesses: 

• File OPEN and CLOSE operations 

• Updating an in-memory window of a file (window-turning); 

Random access to files (such as to an RMS indexed file) uses "window- 
turning" heavily (unless the file is contiguous); FIP buffering greatly 
improves such accesses. 

• Listing directories 

• Wild card file operations 

Normally, FIP uses only one permanently allocated one-block buffer to store 
disk directory information. File processing is often delayed because at any 
given time the directory block that the file processor needs is not in its buffer. 

The FIP buffering code claims free buffers from the normal small buffer pool 
and stores additional directory blocks in them. Frequently used information is 
thus kept in memory to avoid accesses to disk. If any of the buffers are 
required for their standard uses, the FIP buffering module releases them to 
the system. You need not increase the number of small buffers configured for 
other system operations when you include the FIP buffering module on the 
system. 

You can enhance FIP buffering on the RSTS/E system by allocating addi- 
tional memory for use by the FIP buffering module. The XBUF suboption of 
DEFAULT (Section 3.9.4.7) allows you to reserve a fixed amount of memory 
as extended buffer space. The FIP buffering module can use this space as a 
cache for disk directory blocks. 

The module uses the available extended buffer space before it claims small 
buffers and does not use small buffers at all if you allocate more than 8K 
words of extended buffer space. By placing frequently accessed directory 
blocks in a special area of memory (the extended buffer pool), the FIP buffer- 
ing module avoids disk accesses. This process prevents degradation of 
performance on a heavily loaded system, when fast access to directory blocks 
is needed and user jobs claim most of the small buffers. 

With extended buffer space available, the FIP buffering module may increase 
the speed of an individual operation up to ten times or not at all (if the 
operation accesses none of the reserved memory). The module affects the 
performance of system operations that involve computing. Increased overhead 
in the monitor causes this degradation, which can be as low as a fraction of 
1% or as high as 12%. However, the reduced disk activity generally more 
than compensates for degradation of compute operations, except in extremely 
compute-bound systems. Generally, the central processor overhead increases 
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in direct proportion to the improvement in directory related operations. Since 
only one job at a time may use FIP, speeding up FIP may speed up the entire 
RSTS/E system. 

RSTS/E allows you to control the FIP buffering facility with the ENABLE 
CACHE and DISABLE CACHE commands in the UTILTY program. (Refer 
to the RSTS/E System Manager's Guide for further information on the 
UTILTY program.) Therefore, you can disable the module if system use will 
be heavily compute-bound. You can later re-enable the module when speed of 
directory operations is needed. In general, however, the FIP buffering module 
greatly improves system performance and its use is strongly recommended. 



4.2.11 .7 Extended Data Buffering — The extended data buffering option accel- 
erates processing of specified files (that is, files to be cached,) on the RSTS/E 
system. Extended data buffering is located within the monitor and requires at 
least 2K of extended buffer space. The benefits to be gained from this option 
are similar to those from FIP buffering, as are also the trade-off considera- 
tions. Once this has been generated into the monitor you should refer to the 
RSTS/E System Manager's Guide for further information on data caching. 

The extended data buffering feature is not recommended for systems with less 
than 256K words of memory because such systems usually cannot afford to 
allocate large enough XBUF to make it effective. Usually systems with 64K 
to 192K words should use directory caching (FIP buffering) but not data 
caching. 

The best size for XBUF can only be determined by experiment. For directory 
caching, a good starting point is about 10% of memory; for directory and data 
caching, about 15% of memory. 



4.2.11.8 Disk Driver Phase — The disk driver code, ordinarily resident in 
permanently mapped memory, can be built into a separate monitor phase. 
Removing this code can increase the size of your small buffer pool at the cost 
of a physically larger monitor. The actual number of small buffers that are 
made available by selecting this option depends on the types of disks and 
other devices for which support is generated. If you can afford the increase in 
the size of the monitor and need to provide your system with more small 
buffers, include this option at system generation time. 

About 15% of the time, putting disk drivers in a separate phase will make the 
monitor IK words larger, independent of any size increase from added small 
buffers. There is no difference in performance, however, when the disk drivers 
are put into a different phase. 



4.2.11.9 Resident Libraries — A resident library is a collection of shareable 
code and/or data which you can access in a task as part of your virtual 
memory space. This shareable code can reduce access time for programs with 
overlayed code by making the code memory resident and by having more than 
one program use the library. This saves disk access time and also diminishes 
the load on your disk I/O drivers, which frees them for other system tasks. In 
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addition, if there are several programs that require the same code (for exam- 
ple, RMS-11 code) the programs can share that code saving the amount of 
memory that is not duplicated. 

There are a few factors that you must consider before you decide to include 
the optional resident library feature in your monitor. If you have at least 124K 
words of memory and plan to use RMS-11, then you should include this 
feature during the system generation process, so that you may use the 
RMS-llK Resident Library. If you intend to use resident libraries that you 
build yourself, the amount of memory that you need may be less than what is 
recommended when using the 24K RMS-llK Library. This is true if the size 
of your memory resident libraries, when added together, is smaller than 24K 
words. Another factor that you must consider is the increase of approximately 
IK words in the size of your monitor. Even though the resident library is not 
made part of permanently mapped memory, the code that handles resident 
libraries makes the monitor larger. In addition, each job that accesses a resi- 
dent library will use an additional 1 to 3 small buffers. 

Finally, you must weigh all these factors along with the requirements of your 
installation to determine how you should make use of resident libraries. To 
learn how to create your own resident library, refer to the RSTS/E Task 
Builder Reference Manual; refer to the RSTS/E System Manager's Guide or 
the RSTS/E Programming Manual for an explanation of the load procedures 
for a resident library. 



4.2.11.10 RSX Directives — In RSTS/E V7.0, you can add to your system a 
feature which allows the monitor to perform the functions (except the load 
operation) of the RSX Run-Time System (RTS). When you select the RSX 
Directives option during system generation, you direct the SYSGEN system 
to include RSX emulator code in the RSTS/E Monitor. With this feature 
installed, RSX programs will be controlled by the RSX emulator code in the 
monitor rather than by the RSX RTS, which is then only used as a keyboard 
monitor or for loading programs. Once the RSX RTS loads an RSX task into 
memory, RSX passes program control to the RSX emulator in the RSTS/E 
Monitor. Since the monitor executes all subsequent RSX directives, the RSX 
RTS is no longer necessary, and is removed (if not needed) from the user 
address space. This allows the space to be used for expanding (up to 31K 
words) the user program or for mapping a resident library. Previously, 28K 
was the maximum executable task size, and will remain that size if you do not 
select this option or when a program uses a run-time system other than RSX. 
The removal of the 3K word run-time system allows a program using the RSX 
RTS to expand to 31K words, if required. 

The RSX emulator code adds IK words to the size of the permanently 
mapped portion of your monitor. However, you effect a gain of 2K words of 
dynamic memory, since the removal of the RSX RTS can free 3K words of 
memory and the addition of the monitor code brings the net gain to 2K words. 
This is valid on the assumption that RSX is not your system default run-time 
system. 
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Because the RMS-llK Resident Library requires 8K words of user job address 
space, you must select this option when you plan to use the library. Other- 
wise, the run-time system, which requires 4K words of user space, and the 
resident library would take a combined total of 12K words, leaving insuffi- 
cient room for the programs which use the RMS-llK Resident Library. By 
selecting this option, you allow those programs to run without the run-time 
system, giving you 4K words more for your programs. 

NOTE 

Programs which expect to read data (i.e., from the pseudo- 
vector region as described in the RSTS/E System Directives 
Manual) from the RSX Run-Time System will fail on systems 
with the RSX Directives option selected. The message that is 
printed indicating this failure is MEMORY MANAGEMENT 
VIOLATION. 

4.2.11.11 Resident Code — You can configure certain portions of the overlay 
code to be resident in memory rather than to be stored on disk during time 
sharing. System performance improves if frequently used code is made 
resident. The size of each potentially resident segment of code is listed in 
Appendix B. 

The most important code in terms of system performance is the disk-handling 
code. This code includes the following: 1) the system routines for disk file 
creation; 2) OPEN and CLOSE routines; 3) routines for processing the RUN 
command; 4) general routines for opening other devices, deassigning devices, 
retrieving error messages, and looking up files by name; and 5) routines 
needed for logout. Because disk handling code is so frequently used, DIGITAL 
recommends that you configure it as resident, unless memory space is critical 
and all other steps to reduce the size of the monitor have been taken. 

The send/receive code provides interjob communications for such programs as 
OPSER, QUEMAN, BATCH, and RJ2780. If your system applications re- 
quire frequent interjob communication, resident send/receive code improves 
system performance. When DECnet/E is included, Send/Receive is automati- 
cally made resident. 

The simple SYS call code is used whenever a program executes a SYS call to 
the file processor (SYS code 6) or the DATE$ and TIME$ functions in 
BASIC-PLUS. These SYS calls are often used in DIGITAL-supplied system 
library programs. If your system has more than 64K words of memory and 
frequently uses file processor SYS calls, you should make the SYS call 
dispatch code resident. 

The file delete and rename code deletes and renames RSTS/E files. If your 
system is quite large or your applications require an inordinate number of file 
delete and rename operations, you may prefer to make the code resident. 

The login, attach, and attribute code logs in and attaches jobs and performs 
file attribute read/write operations. If your system is large (many jobs logging 
in and attaching during time sharing), you may want to make this code 
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resident. If your system uses languages such as COBOL, BASIC-PLUS-2, 
and RPG II or uses the Task Builder as part of program development, attrib- 
uted files are created and you may again prefer to have this code resident. 
Your choice is to have all the login, attach, and attribute code resident or not. 

The directory listing code gathers information about disk directories, performs 
wildcard disk file lookups, and manipulates file identification blocks for cer- 
tain files. This code is used by the CATALOG command in BASIC-PLUS and 
by PIP.SAV for obtaining directory information. If your system has more than 
64K words of memory and you make moderate use of the PIP utility, then it is 
recommended that you make this code resident. 



4.2.12 BASIC-PLUS Run-Time System Considerations . 

Several optional features are available for the BASIC-PLUS Run-Time 
System. These features include mathematical functions, the PRINT USING 
facility, matrix manipulation, and string arithmetic. 



4.2.12.1 Floating Point Precision and Scaled Arithmetic — You can select 
either single-precision (2-word) or double-precision (4-word) floating point 
format as the type of numeric format to be used on the system. These floating 
point formats are described in the BASIC-PLUS Language Manual. 

Your answers to the FPP, FIS, MATH PRECISION, and FUNCTIONS ques- 
tions establish which mathematical software package the SYSGEN program 
selects from the fifteen math packages included in the RSTS/E distribution 
kit. Table 4-3 describes the math packages. 

The most critical difference among packages is the implementation of floating 
point operations. The PDP-11/45 compatible Floating Point Processor (FPP) 
provides both 2- word and 4- word floating instructions in hardware. The 
PDP-11/40 compatible Floating Instruction Set (FIS) does not provide 4-word 
floating point instructions in hardware. Therefore, on PDP-11/40 computers 
with or without FIS, RSTS/E must use the slower software packages (XL4, 
XT4 or MA4) to perform 4- word floating point operations. 

On PDP-11 computers without FPP hardware, the size of a BASIC-PLUS 
Run-Time System that includes the 4-word floating point software may ex- 
ceed the maximum of 16K words. To avoid exceeding the limit, you must omit 
some optional features when you configure BASIC-PLUS. Choose features 
from Table B-3 of Appendix B so that the total size of the BASIC-PLUS Run- 
Time System is at most 16383 words. 

The scaled arithmetic feature is available only on systems with 4-word float- 
ing point format. Scaled arithmetic is described in the BASIC-PLUS 
Language Manual and the SCALE command is described in the RSTS/E 
System User's Guide. Scaled arithmetic helps users to avoid problems such as 
loss of precision normally associated with floating point calculations. The 
feature is useful for calculating sums that cannot be easily expressed as inte- 
ger quantities, such as dollars and cents amounts. 
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Table 4-3: Two and Four- Word Math Packages 



Math Package 



MA2 

MA2I 

MA2F 

MA4 

MA4F 

XL2 

XL2I 

XL2F 

XL4 

XL4F 

XT2 

XT2I 

XT2F 

XT4 

XT4F 



Description 



2-word without FIS or FPP. 

2-word with FIS. 

2-word with FPP. 

4- word without FIS or FPP. 

4- word with FPP. 

2- word log function without FIS or FPP. 

2-word log function with FIS. 

2-word log function with FPP. 

4-word log function without FIS or FPP. 

4-word log function with FPP. 

2-word trig function without FIS or FPP. 

2-word trig function with FIS. 

2-word trig function with FPP. 

4- word trig function without FIS or FPP. 

4-word trig function with FPP. 



NOTE 

FPP is available for PDP 11/34, 11/45, 11/50, 11/55, and 11/70 processors. It is 
standard on the 11/60. 

FIS is available for with PDP 11/40 and 11/35 processors. 



4.2.12.2 Mathematical Functions — You can reduce the size of the 
BASIC-PLUS language code by omitting the trigonometric functions SIN, 
COS, TAN, ATN; and the logarithmic functions SQR, EXP, LOG, and 
LOGIO. These functions are described in the BASIC-PLUS Language 
Manual Some installations may need only one part of the math functions 
(e.g., the logarithmic functions) and may prefer to delete the other part (i.e., 
the trigonometric functions) in favor of another option. (The polynomial cal- 
culation portion of the math functions is present if either or both of the 
trigonometric or logarithmic functions are included.) Operations such as X^Y 
require the log functions if Y is not an integer. 

4.2.12.3 PRINT USING Option — The PRINT USING optional feature allows 
BASIC-PLUS programs to perform special formatting of output as described 
in the BASIC-PLUS Language Manual. You can reduce the size of the 
BASIC-PLUS by omitting this option. 

4.2.12.4 Matrix Manipulation — BASIC-PLUS can operate on an entire matrix 
using single MAT statements as described in the BASIC-PLUS Language 
Manual. Configure this optional feature if you want to include the matrix 
manipulation (MAT statement) capability. 
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4.2.12.5 String Arithmetic — BASIC-PLUS can, at your option, include the 
special string arithmetic functions SUM$, DIF$, PROD$, QUO$, PLACE$, 
and COMP%. These functions perform arithmetic operations on strings of 
numerics, minus signs and decimal points, with an accuracy of up to 56 digits. 
The string arithmetic functions, although slow to execute, are useful for appli- 
cations such as monetary conversions, which can involve numbers that require 
a high degree of precision. Refer to the BASIC-PLUS Language Manual for 
complete information on the string arithmetic functions. 

4.3 Running the SYSBAT Program 

After you answer the final configuration question, the SYSGEN program 
completes the building of the configuration file (CONFIG. MAC) and the 
batch control file (SYSGEN. CTL). The program then prints a message in- 
structing you to edit the files (if desired) and start the batch process. If editing 
is necessary, use the TECO editor, which is on the distribution tape or disk. 
Refer to the PDP-11 TECO User's Guide for instructions on how to use the 
TECO editor. 

NOTE 

Before using the TECO editor, you must add the TECO Run- 
Time System by performing the following procedures: 

1. Type the command, RUN $UTILTY, then press RETURN. 

2. Type ADD TECO, then press RETURN in response to the 
asterisk (*) prompt. 

3. Type CTRL/Z or EXIT to terminate the UTILTY program. 
The TECO Run-Time System is now installed. At this 
point, you can begin to edit the files. 

Normally, logins have been enabled by CREATE.SAV. If CREATE.SAV has 
not been run since the system was last started, the batch process fails to log in 
and aborts. You should run the UTILTY program and issue the LOGINS 
command before restarting the batch process. Type R SYSBAT in response to 
the dot (.) prompt character to start the batch process. The batch process 
executes commands in the batch control file to generate the RSTS/E Monitor 
Save Image Library (SIL) and the BASIC-PLUS Run-Time System. 

The batch process performs input and output to a pseudo keyboard, and 
prints all pseudo keyboard input and output at the console terminal, two 
spaces indented. As it executes, the batch process may request that you 
mount the distribution medium, ready a line printer (if you requested assem- 
bly listings), and mount the output medium for the Target system. The 
following is an example of a batch process request. 

MOUNT AP-2773G-BC ON A MAGTAPE DRIUE 

WITH NO "WRITE RING" AND SET TO "ON LINE" 

Mount MM: "SYSGNG" -write locked 
Unit ? 
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In response to the UNIT question, type the unit number on which you have 
mounted the tape. 

The batch stream deletes the assembly listing files and other system generation 
files from previous system generations, if they exist. For more information on 
the PIP program refer to the RSTS/E System User's Guide. The following 
appears on the console printout when PIP.SAV is run: 

.R PIP,SAi,' 

#T5L.0BJ »TTDINT.OBJ ^TTDUR ♦ OB J/DE : NOWARN 
*TBL,LST »TTDINT.LST ^TTDVR ♦ LST/DE : NONARN 
*RSTS.SAU »TER,SAV >DSK . SAi,'/DE 5 NONARN 
#EMT,SAV >FIP,SAM »RS)(,SAU ^O^R . SAU/DE : NOWARN 
*RSTS,MAP >TER,MAP »DSK ♦ MAP/DE : NONARN 
*EMT.MAP f PIP, MAP »RSK.MAP »OUR , MAP/DE : NOWARN 
*RSTS.STB »TER.STB >DSK . STB/DE : NOWARN 
*EMT.STB tPIP.STB »RS)<,STB .OVR . STB/DE : NOWARN 
*NSP , SAM f TRN . SAM tXMDMR . SAM »R J2780 , SAM/DE : NOWARN 
*NSP.MAP >TRN,MAP »)<MDMR.MAP »RJ2780 , MAP/DE : NOWARN 
*NSP.STB »TRN.STB >>(MDMR.STB »RJ2780 , STB/DE : NOWARN 

*-c 

If any error messages appear in the batch printout, the system generation 
process may be in error. Refer to Appendix A for a description of these error 
messages. 

When the execution of the batch stream is complete, SYSBAT prints an 
informative message and returns to the dot (.) prompt character. 

4.4 S>huttiog Down the SYSGEN System 

When the batch process completes execution and returns to the dot (.) prompt 
character, shut down the SYSGEN system. 

To shut down the SYSGEN system, run the UTILTY program and issue the 
NO LOGINS, REMOVE TECO and SHUTUP commands. (If you mounted 
any disks that the batch process did not logically dismount, issue the 
DISMOUNT command before issuing the SHUTUP command. If you used 
the TECO editor to edit CONFIG.MAC on SYSGEN.CTL, you must 
REMOVE the TECO Run-Time System before issuing the SHUTUP 
command.). The following example illustrates the procedure. 

.R UTILTY 
*NG LOGINS 
*REMOME TECO 
*SHUTUP 

The UTILTY program disables logins and shuts down the SYSGEN system. 
The shutdown procedure automatically loads into memory and bootstraps the 
RSTS/E system initialization code from the SYSGEN disk. Remove the dis- 
tribution medium and store it in a safe place. After the system initialization 
code prints its identifying message and the OPTION: prompt, you can pro- 
ceed to Chapter 5 to tailor the Target RSTS/E system. 
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NOTE 

After the SYSGEN system has been shut down, you may wish 
to restart it to correct errors that occur in the SYSBAT batch 
process. To return to the configuration dialogue follow these 
steps: 

1. Reboot the system. 

2. Run the START option again. The system will return the 
message 

?CAN'T FIND FILE OR ACCOUNT 

3. Run the UTILTY program by typing: 

,R UTILTY 
4(L0GINS 

#61© 



The system will return the prompt (.). If you type R SYSGEN 
in response to the prompt, the system will return to the 
configuration dialogue. 
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Chapter 5 

Tailoring the Target System 



After generating the Target system, use the initialization code to tailor the 
Target system to your installation. You need to 1) bootstrap the Target disk, 
2) install the Target monitor, 3) correct the system code, 4) manipulate the 
system files, 5) establish default start-up conditions for the Target system, 
6) specify device unit characteristics, and 7) start the Target system. 



5.1 E)ootstirapping the Target Disk 

Before you can install the Target monitor, the initialization code must be 
running and the system device must be the Target disk. If the SYSBAT batch 
process wrote the Target system on the SYSGEN system disk, the system 
shut down procedure has already loaded the initialization code from the 
Target disk. Proceed to Section 5.2 to install the Target monitor. 

If the batch stream wrote the Target system on another disk or on tape, 
bootstrap that disk or tape. Next, if the Target system is to be on a device 
other than the one SYSGEN wrote its output to, use the COPY option to copy 
the Target system files to the Target disk. The copying operation automati- 
cally bootstraps the Target disk. After the Target disk is bootstrapped, you 
can set hardware characteristics (if necessary) . 

5.1.1 Bootstrapping the Disk or Tape 

Use the BOOT option (described in Section 3.12) to bootstrap the disk or tape 
output from the SYSBAT batch process. Type BOOT or BO in response to the 
OPTION: prompt. When the BOOT DEVICE: prompt appears, type the 
device name and unit number of the disk or tape to be bootstrapped. The 
initialization code bootstraps the device and returns to the OPTION: prompt. 
If the Target system is now on the Target disk, proceed to Section 5.1.3 to set 
hardware characteristics. If the Target system is to be on a disk different than 
the one SYSGEN wrote its output to, follow the procedures in Section 5.1.2 to 
transfer the Target system files to disk. 
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5.1.2 Copying Files from Tape to Disl< 

If you have not already initialized the Target disk, use the DSKINT option to 
do so. Type DSKINT or DS to invoke the DSKINT option, and then use the 
option to initialize the disk as a system disk. Refer to Section 3.3 for a com- 
plete description of the DSKINT option. 

After initializing the Target disk, use the COPY option (described in Section 
3.4) to copy the system initialization code, the RSTS/E Monitor SIL, all run- 
time system files, and the default error message file to the Target system disk. 
You must specify /A after the output disk name, to get all auxiliary run -time 
systems as well as your default run-time system onto your system disk. The 
COPY option automatically bootstraps the Target system disk. 

You can now set hardware characteristics for the Target system disk. 

5.1.3 Specifying Hardware Characteristics 

If you have not previously used the Target disk as a system disk (or if the 
Target disk is a fixed head disk), you may need to set console terminal fill 
characteristics and correct the hardware configuration. 

If your console terminal has a fill characteristic other than 0, use the FILL 
option (Section 3.15). The FILL option allows you to set fill characteristics for 
a variety of terminal types. 

The DIGITAL field service engineer who installed your system may have 
informed you of changes that are necessary for your system's hardware config- 
uration. Use the HARDWR option (Section 3.6) to make any necessary 
changes. 

5.2 Installing the Target Monitor 

Use the INSTALL option (described in Section 3.7) to install the RSTS/E 
Target Monitor. To invoke the INSTALL option, type INSTALL or IN in 
response to the initiaHzation code's OPTION: prompt. When the option 
prints the SIL question, type the name you specified for the RSTS/E Monitor 
SIL during the configuration questions. The INSTALL option checks the 
monitor SIL for format, sets bits in the monitor SIL to install it, then returns 
to the OPTION: prompt. Execution of the INSTALL option takes about 30 
seconds. 



5.3 Correcting the System Code 

If you used Autopatch to correct the system code, then most of the patches are 
already in place. Otherwise, use the PATCH option at this point. Note that 
optional patches may be performed here also. Consult the RSTS/E Release 
Notes and issues of the RSTS/E Software Dispatch for patches that your 
system requires. Follow the instructions in the published patch. If you need 
more information on the PATCH option, refer to Section 3.5. 



5-2 Tailoring the Target System 



5.4 Allocating System Files 



The REFRESH option (Section 3.8) creates, deletes, and positions files 
on any disk. If the Target system is on the SYSGEN disk, you should use 
REFRESH to ensure that the system file allocation is correct. If the Target 
system is not on the SYSGEN disk, you probably need to use REFRESH to 
create all the system files. 



5.5 S>etting Default Start-Up Conditions 

The DEFAULT option (Section 3.9) establishes system defaults for job and 
swap maxima, the run-time system, the error message file, the installation 
name, memory allocation, crash dumps, and magnetic tape labelling format. 
Use the DEFAULT option to set these defaults for the newly generated moni- 
tor. You may specify either BASIC-PLUS or RSX as your default run-time 
system at this point. If you intend to use BASIC-PLUS-2 as your default run- 
time system, specify RSX now. 



5.6 S»pecifylng Characteristics for Units of Devices 

The SET option (described in Section 3.10) establishes device characteristics 
on a unit-by-unit basis. If your system includes one or more line printers, use 
SET to declare type, width, and case for each unit. You can also enable and 
disable units of a device, enable and disable modem control for keyboards, 
and restrict the use of devices by unprivileged jobs. 



5.7 Smarting the Target System 

After you specify characteristics for units of devices, use the START option 
(Section 3.11) to start the Target system. You can invoke the START option 
by typing START (or ST) or by pressing LINE FEED. If you type START or 
ST, the START option prints questions that allow you to change certain 
default start-up conditions. After you answer the questions, the START 
option prints a list of all the disabled devices on the system. If you press 
LINE FEED to start time sharing, the START option prompts you for only 
the current date and time and prints only a line telling the number of disabled 
devices on the system. If you omit the questions (i.e., press LINE FEED), 
you cannot change any of the default start-up conditions for the current time- 
sharing session. 
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Chapter 6 

Building System Library Fiies and Optional 
Software 



This chapter explains the procedures you must follow to build the RSTS/E 
utility program library, add auxiliary run-time systems (RTS), and install 
optional software. After you have completed these steps, you will have fin- 
ished the generation of your system and will then be able to perform normal 
time-sharing tasks. 

As a first step toward this end you use the START option as mentioned in 
Chapter 5 to start the Target system. When you perform this task, the moni- 
tor sets up job 1 under the system library account [1,2], then attempts to run a 
system start-up program. If your system default run-time system is 
BASIC-PLUS, this program is SY:[1,2]INIT.BAC (INIT.TSK for RSX). 
Because you have not created the RSTS/E system library and thus have no 
programs in account [1,2], the run-time system prints the message: 

?CAN'T FIND FILE OR ACCOUNT 
7PR0GRAM LOST - SORRY 

READY 

and returns control to keyboard monitor command level. The READY prompt 
indicates that you are currently running under the BASIC-PLUS Run-Time 
System. If an angle bracket (>) appears rather than the READY prompt, you 
are under the control of the RSX Run-Time System. You can now use the 
console terminal (KBO:) as if you had already logged onto the system. At this 
point, your Target system is running, which means you must now either 
transfer files to the Target disk using IVIINCOP or begin to install the RSTS/E 
software required by your installation. 
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6.1 Transfer Files to the Target Disk Using IVIINCOP 

You may have decided earlier in the system generation procedure to place the 
Target system on an intermediate disk or magnetic tape. This means you 
generated the Target system on a medium that you planned not to be your 
final Target system medium. It is advantageous, at times, to generate the 
Target system onto magnetic tape or a small disk (RK05), then transfer it to 
your final Target medium, often a larger disk. Follow these procedures only if 
you created an intermediate Target system (i.e., the Target disk is different 
than the SYS GEN disk) on disk or magnetic tape. You must now transfer the 
information to the final Target medium. 

1. Mount the intermediate Target medium. 

a. If the Target medium is magnetic tape, mount it and invoke the 
MINCOP program at Step B. 

b. If the Target medium is disk, physically mount, then logically mount 
the disk using the following command: 

MOUNT deu :packid/RO 

where dev represents the device name and unit number of the interme- 
diate Target disk. Include the pack identification of the disk and 
specify it read only. 

2. Run the MINCOP program. 

Type RUN dev:$MINCOP, then press RETURN, where dev represents the 
device name and unit number of the intermediate Target disk. MINCOP 
begins to transfer the files and prints copy messages on the console termi- 
nal to indicate the successful completion of each copy procedure. 

6.2 Introduction to the BUILD Program 

DIGITAL supplies on magnetic tape or disk the RSTS/E libraries that you 
will install on your system. Included on the magnetic tape or disk distribution 
media are the RSTS/E utility programs, several control files (Refer to 
Appendix D), and a special program, BUILD. The control files contain com- 
mands that the BUILD program uses to compile the utility programs. After 
BUILD retrieves the programs from the distribution medium and compiles 
them, it places them in the system library account [1,2]. The compiled pro- 
grams in account [1,2] constitute the RSTS/E system library. In addition, to 
ensure that all RSTS/E software is up-to-date, DIGITAL provides, on an 
Autopatch distribution medium, patches that you can apply while using the 
BUILD program. Since BUILD can simultaneously create and patch the 
system library, your first step before you build them will be to mount the 
Autopatch medium. When the medium is mounted and ready, you invoke 
BUILD which then presents you with a sequence of dialogue questions. 
BUILD creates and patches the system library after you respond to all the 
questions. Section 6.6 contains a discussion of the BUILD program as it re- 
lates to creating the standard system library. 
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You can also use the BUILD program to construct the utiHty programs for a 
system default run-time system if you plan to install RSX or BASIC-PLUS-2 
as your default run-time system. Basically, you follow the same procedures 
that you perform to build the RSTS/E libraries; invoke BUILD, answer the 
resulting dialogue questions, and BUILD creates and patches the RSX or 
BASIC-PLUS-2 versions that run under RSX or BASIC-PLUS-2 utility pro- 
grams. If you decide to use one of these two run-time systems as the system 
default, you must build them prior to creating the RSTS/E system libraries. 
To build RSX or BASIC-PLUS-2 as the system default RTS follow the steps 
described in Section 6.5. 

The list that follows summarizes the steps you perform to ensure complete 
generation of your system: 

1. Section 6.3 - Provides standard mount procedures for magnetic tape and 

disk. 

2. Section 6.4 - Mount the Autopatch distribution medium and copy 

patches (if necessary) to the public disk structure. 

3. Section 6.5 - Create and patch the default run-time system and its 

utility programs if it is not BASIC-PLUS. 

4. Section 6.6 - Mount the RSTS/E system library distribution medium. 

Create and patch the standard system libraries. 

5. Section 6.7 - Add auxiliary run-time systems then patch them. 

6. Section 6.8 - Build optional software. 

7. Section 6.9 - Create system message and start-up control files. 

8. Section 6.10 - Create user accounts. 

9. Section 6.11 - Shut down the system, specify default run-time system (if 

required), and create recovery media. 

10. Section 6.12 - Start Time Sharing, Verify System Control Files, and 

Store Distribution and Recovery Media. 

The section that follows explains magnetic tape and disk mount procedures. 

6.3 Magnetic Tape and Disk l\/lount Procedures 

DIGITAL distributes Autopatch kits, system library kits, and optional soft- 
ware kits on either magnetic tape or disk. In this chapter you will be mounting 
these various media at different times during the system generation. Rather 
than duplicate the mount procedures throughout the chapter, they are pre- 
sented here. Refer to this section when you need to mount either medium. 
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6.3.1 Mounting Magnetic Tape 

To mount the magnetic tape perform these steps: 

1. Ensure that there is no write-enable ring on the reel. 

2. Mount the reel on a free magnetic tape drive. 

3. Position the tape at its load point. 

4. Set the ON-LINE/OFF-LINE switch to ON-LINE. 

6.3.2 Mounting Disic 

To mount a disk, perform the following steps: 

1. Mount the disk on a free disk drive. 

2. Set the unit's RUN/STOP (for RK06 and RK07) or LOAD/RUN (for 
RK05) switch to RUN; press the LOAD switch to the in position for 
RLOl's. 

3. Set the unit's write-protect switch on. 

4. When the unit's READY light comes on, logically mount the disk by 
typing the following command: 

MOUNT deM : pacKid/RO 

where dev: is the device mnemonic and the unit number of the disk and 
packid is the identifier listed in Section 1-3. 

If you will always have one or more public disks mounted besides the system 
disk, you may use the MOUNT command now to mount them. This will allow 
subsequent procedures to use the extra disk space. 



6.4 Mounting the Autopatch Distribution IVIedium and Copying 
Patches to the Target Disic 

The BUILD program allows you to simultaneously create and patch the 
standard system library. If you have an Autopatch distribution medium for 
the system library, you must mount it at this time. Since DIGITAL distrib- 
utes the Autopatch kit on both magnetic tape and disk, you will need to follow 
the appropriate mount procedures for the type of distribution you have. A 
description of these procedures appears in Section 6.3.1 for magnetic tape and 
in Section 6.3.2 for disk. After you have successfully mounted the kit, you may 
need to transfer the patches to the public disk structure. If you have a mag- 
netic tape distribution kit, you must use the PATCPY program, described in 
Section 6.4.2, to transfer patches from the kit to the public disk structure. 
BUILD requires that the patches be on disk. You may also need to transfer 
patches to disk even if you have a disk Autopatch kit (see Section 6.4.1 2b). 
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6.4.1 Mounting the Autopatch Distribution IVIedium 

Perform the following steps to mount the Autopatch kit: 

1. Magnetic tape distribution medium. 

a. Mount the magnetic tape as described in Section 6.3.1. 

b. Go to Section 6.4.2 because BUILD requires the patches on disk. 

2. Disk distribution medium. 

a. Mount the disk as described in Section 6.3.2. 

b. The BUILD program can apply patches to the standard system library 
programs only if the patches reside on disk. If you do not have enough 
free disk drives available so that the Target disk, the Autopatch distri- 
bution, and the library distribution medium can be mounted at the 
same time, then you must transfer the patches from the patch kit to 
the system disk. If you need to move the patches to the system disk, 
perform the procedures in Section 6.4.2. However, if you have enough 
free drives, then you may keep the patches on the patch kit and have 
the BUILD program apply the patches directly from the Autopatch kit. 
In this case, it is unnecessary for you to transfer the patches to disk, 
and you do not need to perform the steps in Section 6.4.2. Proceed 
instead to Section 6.5. 

6.4.2 Using PATCPY to Copy Patches from the Autopatch 
Distribution IVIedium 

Run the PATCPY program if you need to transfer patches from the Autopatch 
distribution medium. The procedures that follow assume you have mounted 
the distribution medium as described in Section 6.4.1. Perform these steps: 

1. Type RUN dev:$PATCPY if your default run-time system is 
BASIC-PLUS. Replace dev with the mnemonic name and unit number of 
the device that the library distribution is mounted on, then press 
RETURN. However, if your default run-time system is RSX, type RUN 
SY:$PATCPY. After PATCPY prints its header line, PATCPY presents 
the following dialogue: 

ENTER DISTRIBUTION DEi,'ICE/PPN < SY : [ 1 »2 3 > 5 

Respond with the name and unit number of the device on which the patch 
kit is mounted. A typical response might be MTO:. It is not necessary to 
specify an account, since the files are distributed in the default account 
[1,2]. PATCPY next asks you where you would like it to copy the patches. 

ENTER OUTPUT DEUICE/PPN < SY : C 200 »200 ] > : 

Reply with an account that you would like to hold the patching files. 
DIGITAL suggests that you reserve account SY: [200,200] for this purpose; 
therefore, respond by pressing RETURN. If you specify an account that is 
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not already created on your system, PATCPY responds with a warning 
message and another question: 

ICM'J FIND FILE OR ACCOUNT 

ATTEMPT TO CREATE ACCOUNT SY:CPPN] <N0>? 

The %CAN'T FIND FILE OR ACCOUNT message indicates the account 
you specified does not exist on your system. To accomodate, PATCPY 
asks the ATTEMPT TO CREATE ACCOUNT question to give you the 
opportunity to have the account created. If the bracketed PPN [PPN] is 
the account number you want to create, answer the question by typing 
YES, then press RETURN. This procedure will create the account. If you 
do not want the account created, press RETURN to accept the <N0> 
default and return to the ENTER OUTPUT/DEVICE PPN question. 
After you terminate your response, PATCPY asks, in the following ques- 
tion, the name of the command files you want transferred. 

PACKAGES TO PATCH? 

Respond to this question by typing one or more of the package names 
found in Table D-1. To specify more than one package name at one time, 
you can string them together by separating them with commas. To ensure 
that all the package names you might use during the BUILD procedure 
are transferred, type ALL, then press RETURN. The ALL response 
instructs PATCPY to transfer the entire patch kit. If you type an unrecog- 
nized package name such as HELP, PATCPY lists all the package names 
it knows. Once you enter any valid response, PATCPY prints the 
question: 

OTHER WILD CARD STRINGS? 

Press LINE FEED. Entering wildcard strings is useful for customer patch- 
ing kits, but should not be necessary when patching the RSTS/E libraries. 
After you press LINE FEED, PATCPY copies the files. Note that the 
PATCPY operation copies several files in addition to those needed by any 
individual package. The BUILD program uses the required files only, and 
ignores the others. As PATCPY transfers each file from the Autopatch 
distribution medium to the account, it prints: 

COPYING < f i 1 e s p e c > TO < f i 1 e s p e c > 

If you do not want this output printed, type CTRL/0 to suppress the 
output. 

2. When PATCPY finishes copying files, it prints: 

nnn FILES COPIED 

COPY OPERATION COMPLETE 

where nnn represents the number of files copied. If your patches were 
distributed on disk, PATCPY asks the following dismount question: 

LOGICALLY DISMOUNT <deu>: <YES>'? 

Dismount the disk device represented by <dev> by pressing LINE FEED. 
Type N if you do not want the device logically dismounted. 
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You have completed the copy operation and are now prepared to build and 
patch the system default run-time system if it is to be RSX or 
13ASIC-PLUS-2; continue at Section 6.5. If neither of these are to be your 
system default run-time system, proceed to Section 6.6 to build the standard 
system libraries. 

6.5 Build and Patch System Default Run-Time System - RSX or 
BASIC-PLUS--2 

BASIC-PLUS, RSX, or BASIC-PLUS-2 can be your default run-time system 
(RTS). At this point in the system generation process you are running either 
in BASIC-PLUS or RSX. To determine which run-time system you are run- 
ning under, check the preceding dialogue sequence for your response to the 
DEFAULT option RUN-TIME SYSTEM question. Also, the run-time system 
prompts, READY and angle bracket (>), can determine your current RTS. 
READY indicates you are running under BASIC-PLUS and the angle bracket 
character (>) signifies that you are in the control of RSX. If you are in 
BASIC-PLUS and want it to be your system default run-time system, then go 
to Section 6.6 to begin the BUILD of the standard system library files. If you 
want RSX or BASIC-PLUS-2 to be your default run-time system, follow the 
procedures described in this section. Note that since the BASIC-PLUS-2 
RTS requires the RSX version of the system library files, you must build RSX 
before building BASIC-PLUS-2. 

Now that you have decided to select either RSX or BASIC-PLUS-2 as your 
system default run- time system, you are ready to build the utility programs 
associated with the RSX Run-Time System. To perform this task you will be 
using the BUILD program, the same program that creates the standard sys- 
tem library files discussed in Section 6.6. Follow the steps in sequence to 
install either/both of these run-time systems: 

1. Mount the RSX distribution medium containing the RSX utilities. 

a. If the RSX kit is on magnetic tape, follow the mount instructions 
described in Section 6.3.1. Begin the BUILD at step 2. 

b. If the RSX kit is on disk, follow the mount instructions described in 
Section 6.3.2. Continue at Step 2. 

You are now ready to begin the BUILD of the default run-time system 
at Step 2. 

2. Begin the BUILD dialogue. After you have successfully mounted the dis- 
tribution medium, type the following RUN command to invoke the 
BUILD program and to start the dialogue sequence: 

RUN SY:$BUILD 

After you terminate the command by pressing RETURN, BUILD prints 
its header line as follows: 

BUILD V7.0 RSTS ^7.0 Time Sharing 
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Following the header, BUILD prints the first dialogue question. 

SYSTEM BUILD <N0>? © 

Press LINE FEED or type NO in response to this question. Do not type 
YES. A YES response is only necessary when you are first building the 
library under BASIC-PLUS. 

SOURCE INPUT DEVICE <SY:>? deu: 

Type the device mnemonic and the unit number of the distribution medi- 
um. Terminate your response by pressing RETURN. BUILD now knows 
the device on which the RSX utility programs reside. 

LIBRARY OUTPUT DE>JICE <SY:>? © 
TARGET SYSTEM DEi.'ICE <SYO:>? © 
LIBRARY ACCOUNT <C1»2]>? © 

Press LINE FEED in response to the last three questions. When you 
accept the defaults, you instruct BUILD to place the RSX utility pro- 
grams on the public disk structure in account [1,2]. BUILD then asks the 
question: 

CONTROL FILE IS? RSX 

to which you type RSX. As soon as you terminate your response by pressing 
RETURN, BUILD prints a copy file message to indicate it is transferring 
the RSX build control file to a temporary file on the system disk. 

*** COPYING FILE d e m : [ 1 t2 ] RSX . CTL TO BLD1»TMP *** 
LOCATE LOGICAL 'LB:' ON <SY:C1»1]>? 

It is recommended that you specify an account other than [1,1] as the 
location for the system-wide logical LB:. Various files used by the RSX 
utility programs are stored on the logical device LB:. Initially, LB: stands 
for SY:[1,1], but storing these files in [1,1] (the IVIaster File Directory) 
clutters the IVIFD and slows access to user accounts and other files. If you 
do not accept the default, type the disk mnemonic name, unit number, a 
colon (:), and the account number of the library account. 

BUILD asks in the next question if you want to build and patch, patch, or 
build the RSX programs. 

FUNCTION (BUILD/PATCH t PATCH » BUILD) < 5U I LD/ PATCH >? © 

If you accept the default, you instruct the BUILD program to patch the 
RSX utility programs (if there are patches to apply) at the same time it 
performs the build operation. Specify the default option, BUILD/PATCH. 
The BUILD program processes the RSX utility programs properly even if 
it finds no RSX patches on the Autopatch kit. If you do respond to the 
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FUNCTION question with either the BUILD/PATCH or the PATCH 
option, BUILD asks the following patch related questions: 

PATCH FILE INPUT LOCATION < SY : C 200 .200 ] >? 

BUILD asks you, in this question, for the location of the Autopatch kit. If 
your DIGITAL distributed patch kit is physically and logically mounted, 
type dev:[l,2], since DIGITAL places the patches in that account. If you 
transferred the patches from the Autopatch distribution medium using 
PATCPY, then you must type the same device name and account location 
you specified during the PATCPY operation (Section 6.4.2). If you placed 
the patches on the public disk (SY:) in account [200,200], accept the 
default by pressing RETURN. 

SAME PATCHED SOURCES <N0>? 

Due to the manner in which the RSX Run-Time System utility programs 
are patched, there are no RSX patched sources saved. Press LINE FEED 
to accept the <N0> default. BUILD asks, in the next question, for the 
name of any additional control files you want processed. 

ADDITIONAL CONTROL FILE IS < N N E > ? © 

Since you want to build only the RSX utility programs at this time and 
you have already informed BUILD of this fact when you typed RSX in 
response to the CONTROL FILE IS question, press LINE FEED. This 
response instructs BUILD to begin processing the RSX control file. 
BUILD notifies you when it finishes this process; it prints the message 
that follows: 

*** BUILD COMPLETE *** 

Since the RSX utility programs are now built, you can now dismount the 
RSX distribution medium (if disk) by typing: 

RUN SY:$UTILTY*SAt.' 

After you type UTILTY.SAV, UTILTY prints an astrisk (*) prompt. Type 
DISMOUNT dev: in response to this prompt, where dev is the device 
mnemonic and unit number of the distribution medium. Terminate your 
reply by pressing RETURN. When UTILTY completes the dismount oper- 
ation, it reissues the asterisk prompt. To the second prompt, type 
CTRL/Z, which takes you out of program mode and places you under the 
control of your run-time system. The entire UTILTY dismount procedure 
would appear as follows: 

RUN SY:$UTILTY»SAi,' 
^DISMOUNT deu: (E) 

* gTRL/Z ) 

If you want RSX as your default run-time system, you may now proceed to 
Section 6.6 to begin building the standard system library. If you want 
BASIC-PLUS-2 to be your default run-time system, continue at Step 3. 
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3. If you have a BASIC-PLUS-2 VI. 6 distribution kit, you can build the 
BASIC-PLUS-2 Run-Time System, at this point, by following the instal- 
lation instructions found in the BASIC-PLUS-2 Installation Guide. Refer 
to that document for complete instructions. 

NOTE 

If for any reason you need to reboot your system after you 
build BASIC-PLUS-2, you must again add the 
BASIC-PLUS-2 Run-Time System before proceeding to 
Section 6.6. This procedure is necessary since the system 
returns to the original system default run-time system 
which in this case is RSX. That is, BASIC2 and BP2C0M 
are no longer valid run-time systems. To add 
BASIC-PLUS-2 follow these steps: 

Type RUN $UTILTY; UTILTY issues an asterisk prompt 
(*) to which you type, 

*ADD BPZCOM® 

After you press RETURN, UTILTY prints another prompt. 
You type ADD BASIC2 in response to the asterisk as 
follows: 

*ADD BASIC2 

After the next asterisk prompt, type CTRL/Z. The entire 
dialogue appears as follows: 

RUN $UTILTY 

UTILTY M7.0 RSTS M? . TIME SHARING 

*ADD BP2CQM (H) 
*ADD BASIC2 EH) 

You are now ready to BUILD the system libraries. 



6.6 Mount the RSTS/E System Library Distribution [\/iedium and 
Build the Standard System Library 

This section explains the procedures you must follow to create a system utility 
library from a RSTS/E distribution medium. DIGITAL issues RSTS/E 
programs and system library control files on its system library distribution 
medium. DIGITAL also includes on the distribution kit in account [1,2] a 
special program, BUILD, which you use to create the RSTS/E libraries. After 
you invoke the BUILD program with a RUN command, BUILD presents you 
with a sequence of dialogue questions. One of the questions asks for the name 
of the control file you want BUILD to process. Once you have specified the 
control file, the BUILD program uses commands found in that control file to 
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read the programs from the distribution medium, patch them, compile them, 
and place them in the system library account [1,2]. The compiled programs 
that BUILD places in account [1,2] constitute the RSTS/E standard system 
library. 

BUILD. CTL, SPLER.CTL, BIGPRG.CTL, BACKUP. CTL, and 
DEVTST.CTL represent the five control files that DIGITAL supplies with its 
library distribution medium. Of the five, BUILD. CTL is the only control file 
that you must process with the BUILD program, since the programs compiled 
and placed in account [1,2] by this control file are required by all RSTS/E 
systems. Build the other system library programs only if you plan to include 
their optional features in your system. 

Follow this sequence of steps to mount and then create the standard system 
libraries: 

1. Mount the Standard System Library distribution medium. 

a. If you have a system library magnetic tape distribution kit, follow the 
tape mounting instructions described in Section 6.3.1. After mounting 
the magnetic tape, proceed to Step 2. 

b. If you have a disk system library distribution kit, follow the disk 
mounting instructions described in Section 6.3.2. Proceed to Step 2 as 
soon as you successfully mount the disk. 

2. Run the BUILD program to begin creating the RSTS/E utility libraries. 
To perform this task while running under the BASIC-PLUS Run-Time 
System, type the following command: 

RUN deMS$BUILD 

The dev represents the device mnemonic and unit number of the drive on 
which the device is mounted. For example, you might type RUN 
]V[TO:$BUILD if the RSTS/E library distribution medium was supplied to 
you on magnetic tape and you mounted it on the unit drive. 

If you are under the control of the RSX Run-Time System, however, type 
the following command: 

RUN SY:$BUILD 

The BUILD program presents the following sequence of dialogue questions: 

SYSTEM BUILD <N0>? 

Since there are five libraries that you can create using the BUILD pro- 
gram, you may need to invoke BUILD several times. The first time you 
invoke BUILD, you must type YES if you are running under the 
BASIC-PLUS Run-Time System; type NO thereafter. If you are under 
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the RSX or BASIC-PLUS-2 Run-Time System, always accept the NO 
default to this question. 



SOURCE INPUT DEUICE <SY:>? 



Type the device name of the disk that contains the RSTS/E libraries and 
the unit number of the drive (followed by a colon) on which the libraries 
are mounted. The SOURCE INPUT DEVICE question can take, in addi- 
tion to the dev: specification, a logfile and various switches. With a logfile 
specified you can instruct BUILD to create a logfile of the BUILD opera- 
tion. Write the command in the following format: 

(loafile=)deM:[/5witche5] 

where logfile is the file specification of the file in which to log the BUILD 
procedure and dev is the source input device. The switches that you can 
append to the command are: 

1. /DEN[SITY]:800 - 800 bpi magnetic tape density. 

2. /DEN [SITY]: 1600 - 1600 bpi magnetic tape density. 

3. /PAR[ITY]:ODD - odd parity for magnetic tape. 

4. /PAR[ITY]:EVEN - even parity for magnetic tape. 

5. /DOS - DOS magnetic tape labelling. 

6. /ANSI - ANSI magnetic tape labelling. 

7. /DET[ACH] - causes BUILD to detach from the console terminal 
(KB:). If you specify a logfile and the /DETACH switch, you can speed 
up some BUILD/PATCH procedures because this eliminates time 
spent waiting for the KB: output. If you do not use the /DETACH 
switch and specify a logfile, then the BUILD operation is logged in the 
logfile as well as printed on KB:. 

NOTE 

DIGITAL recommends that the /DETACH switch not 
be used until after the standard system library 
(BUILD.CTL) is built. 

Whether you specified a logfile and switch or merely a device and unit 
number, press RETURN to terminate your response. The next question 
that BUILD asks is: 

LIBRARY OUTPUT DEi^ICE <SY:>? 

If you press LINE FEED to accept the default, you force BUILD to place 
the library programs on the public disk structure. If you want to place the 



6-12 Building System Library Files and Optional Software 



libraries on a specific disk, type the device mnemonic and the unit num- 
ber of the disk on which you want the programs placed. Terminate your 
response with a colon (:), then press RETURN. 



TARGET SYSTEM DEUICE <SYO 



Specify the device name of the disk which will be your system disk and the 
unit number of the drive on which it is mounted. Type a colon (:), then 
press RETURN. If your Target disk is to become your system disk, press 
LINE FEED to accept the SYO: default. 

LIBRARY ACCOUNT <Clt2]>? 

BUILD places the library programs in account [1,2] if you press LINE 
FEED. It is recommended that you accept the default. 

There are five library control files that DIGITAL supplies with the 
RSTS/E system library distribution medium: BUILD.CTL, SPLER.CTL, 
BIGPRG.CTL, BACKUP.CTL, and DEVTST.CTL. Using the 
BUILD.CTL control file, BUILD creates the standard system library, 
which is required by all RSTS/E systems. Note that it is the only control 
file that must be processed. Therefore, if you typed YES in response to the 
SYSTEM BUILD question, BUILD assumes that BUILD.CTL is the first 
control file you will process. As a result, BUILD automatically retrieves 
BUILD.CTL from the distribution medium after you answer the 
LIBRARY ACCOUNT question. BUILD notifies you of its action by print- 
ing the following copying message: 

**# COPYING FILE d e m s C 1 >2 3 BU I LD . CTL TO BLDl.TMP *** 

If you typed NO or pressed LINE FEED to accept the default to SYSTEM 
BUILD <N0>?, BUILD would have printed, immediately after the 
LIBRARY ACCOUNT question, the following: 

CONTROL FILE IS? 

If you are running under the BASIC-PLUS Run-Time System, BUILD 
knows that BUILD.CTL is the first control file it must process and, as a 
result, does not ask you the CONTROL FILE IS question the first time 
through the dialogue. However, if you are under the control of the RSX 
Run-Time System, BUILD does ask you for the name of the control file 
you want to process. Respond by typing BUILD which is the control file 
you must process first. After you process BUILD.CTL, you may indicate 
the names of the other control files that you want built. 

LOCATE LOGICAL 'LBs' ON < SY s C 1 > 1 ] >? 

The account you type in response becomes the location for the system- 
wide logical LB:. It is recommended that you specify an account other 
than [1,1] as the location for the system- wide logical LB:. Various files 



Building System Library Files and Optional Software 6-13 



used by the RSX utility programs are stored on the logical device LB:. 
Initially, LB: stands for SY:[1,1], but storing these files in [1,1] (the Master 
File Directory) clutters the MFD and slows access to user accounts and 
other files. If you do not accept the default, type the disk device name, 
unit number, a colon (:), and the account number of the system library 
account. 

FUNCTION (BUILD/PATCH > PATCH t BUILD) < BU I LD/ PATCH >? 

You now have the option to BUILD/PATCH, PATCH, or BUILD the 
standard system library. If you mounted an Autopatch distribution me- 
dium as described in Section 6.4, you should accept the default by press- 
ing LINE FEED. This not only instructs the BUILD program to create the 
Hbrary using the BUILD. CTL control file but also instructs BUILD to 
apply any patches as the library is being built. Since you usually do not 
know if there are patches for a particular library on the Autopatch medi- 
um, specify the BUILD/PATCH option. Even if there are no patches for 
the programs that comprise the standard system library, BUILD will pro- 
cess the control file properly. Type BUILD if you know that you do not 
have any patches to apply or if you want to patch separately later. If you 
only need to patch the library programs, specify PATCH. 

PATCH FILE INPUT LOCATION < SY : < C 200 ^200 ] >? 

BUILD only asks the patch questions if you either typed BUILD/PATCH 
or PATCH in response to the previous question. If you transferred the 
patches from the Autopatch distribution medium to the public disk struc- 
ture, then you must respond to this question with the same device name 
and account location you specified during the PATCPY operation (See 
Section 6.4.2). You may have placed the patches on the public structure 
(SY:) in account [200,200]. If you did, press LINE FEED and accept the 
default. However, if your DIGITAL distributed Autopatch kit is on a disk 
and is physically and logically mounted, type dev:[l,2], where dev is the 
device name and unit number of the Autopatch distribution medium. 

SAME PATCHED SOURCES <N0>? 

You can retain the compiled and patched library programs if you type 
YES or Y, then press RETURN. If you decide not to save them, press 
LINE FEED. You may find it unnecessary to save the patched sources, 
since reproducing them is not difficult and retaining them on disk ties up 
valuable disk space. If you do not save the sources, BUILD skips the next 
patch question and asks the ADDITIONAL CONTROL FILE IS question 
instead. If you save them, BUILD asks where you want them placed. 

WRITE PATCHED SOURCES TO < SY : < C 200 »200 3 >? 

Provide BUILD with a device name, unit number, and account location 
for the patched sources. For example, you might want to place the sources 
on an RK05, on drive number 1 in account [3,154]; type DKl: [3,154]; press 



6-14 Building System Library Files and Optional Software 



RETURN. Another alternative is to place the sources on magnetic tape. If 
neither of these alternatives is desirable, accept the default which allows 
BUILD to position the sources in account [200,200] on the public disk 
structure (SY:). 



RUN- TIME SYSTEM <xxxxxx> 



BUILD prints the name of the system default run-time system in the 
default field. If the default that BUILD prints in angle brackets is your 
run-time system choice, press LINE FEED. Otherwise, specify the run- 
time system under which this package is to be run. Press RETURN and 
BUILD asks the next question if your response was not BASIC-PLUS. 

USE CUSP COMPILER 'CSPCOM' <YES>? 

If you selected either the RSX or BP2C0M Run-Time System, BUILD 
asks this queston. Choosing RSX causes BUILD to print a YES default; 
selecting BASIC-PLUS-2 causes BUILD to print a NO default. In either 
case, press LINE FEED. 

BUILD prints the LOCATE ERROR PACKAGE ON question as its next 
prompt if BUILD encounters no problems. 

BUILD may not accept your response to the RUN-TIME SYSTEM ques- 
tion and thus will not have asked the previous question. Instead, it notifies 
you of an error by printing one of the following messages: 

1) xxxxxx IS NOT A KEYBOARD MONITOR 

2) RUN-TIME SYSTEM MUST HAME A DEFAULT EXECUTABLE EXTENSION OF 
,BAC OR ,TSK 

3) xxxxxx IS NOT INSTALLED 

After BUILD prints either of the first two messages, it reprompts the 
RUN-TIME SYSTEM question. Enter a new run-time system name that 
conforms to the restrictions indicated in the error message. If BUILD 
issues the xxxxxx IS NOT INSTALLED message, it indicates that it has 
found the specified run-time system in account [0,1], determined that it 
has a .RTS extension, but has also discovered the run-time system is not 
installed. Immediately after printing this message, BUILD asks, in the 
following question, if you want to install the run-time system. 

ATTEMPT TO INSTALL xxxxxx <N0>? 

The default field represents the run-time system BUILD will attempt to 
install. Press LINE FEED to return to the RUN-TIME SYSTEM prompt. 
Type YES and one of the following situations occurs: 

1) BUILD installs the run-time system successfully and prints the mes- 
sage xxxxxx INSTALLED. BUILD then asks the CUSP COMPILER 
question if you selected RSX or BP2C0M as your default RTS. 
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2) BUILD installs the run-time system, determines if it is a keyboard 
monitor and checks for the correct extension. If either condition is not 
met, BUILD prints one of the two following error messages: 

a. xxxxxx IS NOT A KEYBOARD MONITOR 

b. RUN-TIME SYSTEM MUST HAVE A DEFAULT EXECUT- 
ABLE EXTENSION OF .BAG OR .TSK 

After printing either of these messages, BUILD informs you that it is 
removing the previously installed run-time system by printing the 
xxxxxx WILL BE REMOVED message. The program returns to the 
RUN-TIME SYSTEM question. 

3) BUILD may detect errors other than those already described. When it 
does, it prints the message: 

RUN-TIME SYSTEM OPERATION FAILED <text> 

The <text> field can be any valid RSTS/E error message. After print- 
ing the error, BUILD returns to the RUN-TIME SYSTEM question. 

After BUILD successfully installs the run-time system, it prints the fol- 
lowing question. 

LOCATE ERROR PACKAGE ON <SY:C1»23>? 

There are several programs in the standard system library that constitute 
the RSTS/E Error Package. BUILD gives you the option to locate the 
package anywhere on your disk structure. Type the device name, unit 
number, a colon (:), and an account number if you want to locate the 
Error Package in an account other than [1,2], for example [1,10]. General- 
ly, it is advantageous to place the Error Package in an account other than 
[1,2], since that account can become crowded and thus difficult to access 
efficiently. If you do specify an account rather than accept the default and 
the account does not exist, BUILD asks if you want it created. 

ATTEMPT TO CREATE ACCOUNT Cfttfn] <N0>? 

If you want the account, represented by the field [n,m], to be created, type 
YES. Otherwise, press LINE FEED to return to the LOGATE ERROR 
PAGKAGE prompt. 

ADDITIONAL CONTROL FILE IS <NONE>? 

Before BUILD begins to process the BUILD. GTL control file and before it 
creates the standard system library, it asks you if there are any other 
control files you want it to process. You can, at this point, specify the 
names of all the control files that are supplied on the mounted distribu- 
tion medium. For instance, if the SPLER.GTL control file resides on your 
distribution kit, type SPLER.GTL in response to this question. BUILD 
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will process that control file after it creates the standard system library 
using the BUILD, CTL control file. Each time you specify a control file, 
BUILD prints a copying file message similar to the one that appears for 
the SPLER.CTL control file: 

*** COPYING FILE d e m : C 1 »2 3 SPLER * CTL TO BLDl.TMP #** 
LOCATE <SYSTEM PACKAGE) ON <SY:[1»2]> 

The < SYSTEM PACKAGE > field, when it appears on the console termi- 
nal, contains the name of the package that BUILD creates using the 
control file you specified in response to the ADDITIONAL CONTROL 
FILE IS question. Specifically, the field can contain SPOOLING 
PACKAGE, BACKUP PACKAGE, DEVTST PACKAGE. The BIGPRG 
control file is not a package; its individual programs may manually be put 
in different accounts after they are built. By default, the packages are 
located in the system library account [1,2]. If you want the programs there, 
press LINE FEED. Otherwise, specify your own disk and account to re- 
duce clutter in the system library account. Type the device mnemonic, 
unit number, colon (:), account number, and press RETURN. BUILD 
reprompts with the ADDITIONAL CONTROL FILE IS question until you 
press LINE FEED. Accepting the <NONE> default indicates that you 
have no more files to process. As soon as you terminate your response, 
BUILD begins to read the control file, interpret the commands contained 
in the file, patch if specified, compile the programs, and place them in the 
system library account. BUILD notifies you when it finishes processing. It 
prints the following message: 

*** BUILD COMPLETE *** 

At this point, you may need to process other control files. If the system 
library distribution medium that you have already mounted contains 
more control files that you want BUILD to process, follow the procedures 
described at Step 3. However, if you have used BUILD to process all the 
control files on the kit and want to process more, dismount the exhausted 
kit and mount the distribution kit that contains the remaining control 
files. Before you physically dismount a disk kit you must logically dis- 
mount it using the UTILTY program. Type: 

RUN $UTILTY 

and press RETURN. The UTILTY program prints its header line and the 
pound sign (#) prompt as follows: 

UTILTY gV.O RSTS U7,0 TIME SHARING 

In response to the pound sign prompt, type DISMOUNT dev:, where dev 
is the device mnemonic and unit number of the system library distribu- 
tion medium. Append a colon (:) to your reply before you press RETURN. 
UTILTY logically dismounts the device and issues another pound sign 
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prompt. To the second prompt type CTRL/Z. The entire dialogue could 
appear as follows: 

RUN $UTILTY 

UTILTY i.'7,0 RSTS i.'7 . TIME SHARING 

^DISMOUNT DKO: 

sSbED 

Mount the system library distribution medium that contains the remain- 
ing control files and programs that you want BUILD to process. See Sec- 
tion 6.3.2 for these procedures. Continue the BUILD operation at Step 3. 

Invoke the BUILD program, as you did in Step 2, and respond to the 
questions that result. This time through the dialogue, accept the default 
NO answer to the SYSTEM BUILD question by pressing LINE FEED. 
You can now go back to the SYSTEM BUILD question and reply to the 
remaining questions as you did before. When you get to the CONTROL 
FILE IS question, respond by typing the name of the control files you 
want BUILD to process. After you have built all the system libraries, go to 
Section 6.7. 



6.7 Add Auxiliary Run-Time Systems 

When you plan to include optional software such as BASIC-PLUS-2, 
COBOL, FORTRAN IV, or RPG II in your system, you should first install the 
run-time system support required by the optional software. Run-time system 
support includes the actual run-time systems and their associated utilities. 

For the optional language processors, you need to include RSX Run-Time 
System support for the following languages: 

BASIC-PLUS-2 

COBOL 

RPG II 

FORTRAN IV PLUS 

You also must install RMS-llK support for COBOL and RPG II, and option- 
ally for BASIC-PLUS-2. 

All optional software requires the RTll Run-Time System and the PIP.SAV 
program, both provided on the RSTS/E distribution medium. Both are auto- 
matically part of your system. 

Some optional software assumes the BASIC-PLUS Run-Time System. For 
these products you should ensure that the BASIC-PLUS Run-Time System is 
added, then SWITCH to it prior to performing the installation procedures. 
Refer to the appropriate installation manual for further information. 

The following Sections, 6.7.1 and 6.7.2, describe the procedures you must 
follow to add the RSX and RMS 11 Run-Time Systems to your system. 
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6.7.1 Adding RSX Run-Time System and Library 

If your system default run-time system is RSX or BASIC-PLUS-2, you have 
already added the RSX Run-Time System and built the RSX utility pro- 
grams. However, if you have not built the RSX Run-Time System or its 
utility programs, you may do so now. 

To add RSX support, perform the following steps: 

1. Mount the RSX distribution medium. 

a. If your distribution medium is magnetic tape, follow the tape mount- 
ing procedures described in Section 6.3.1. After mounting the magnetic 
tape, proceed to Step 2. 

b. If your distribution medium is disk, perform the disk mounting proce- 
dures described in Section 6.3.2. Proceed to Step 2 after you success- 
fully mount the disk. 

2. Run the BUILD program as described in Section 6.6 (Step 2) but respond 
to the SYSTEM BUILD question by pressing LINE FEED and reply with 
RSX to the CONTROL FILE IS question. 

6.7.2 Adding RMS-11K Software 

To add RMS-llK support, perform the following steps: 

1. Mount the RMS-llK distribution medium. 

a. If your distribution medium is magnetic tape, follow the tape mount- 
ing procedures described in Section 6.3.1. After mounting the magnetic 
tape, proceed to Step 2. 

b. If your distribution medium is disk, follow the disk mounting proce- 
dures described in Section 6.3.2. Proceed to Step 2 after you success- 
fully mount the disk. 

2. Run the BUILD program as described in Section 6.6 (Step 2), but respond 
to the SYSTEM BUILD question with LINE FEED and reply RMSll to 
the CONTROL FILE IS question. 

Refer to the RMS-11 Installation Guide. 



6.7.3 Building the SORT Utility Package 

The SORT Utility Package allows you to read an input file, sort it, and write 
the data to an output file. In order to install this optional software on your 
RSTS/E system, you must first mount the distribution medium containing 
the SORT Utility Package, invoke the BUILD program, and answer the re- 
sulting BUILD dialogue questions. Both Sections 6.5 and 6.6 provide detailed 
descriptions of these questions. Since these sections describe the specific pro- 
cedures for building the default run-time system and the system libraries, the 
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following is a discussion of the separate procedures you must follow in order to 
build the SORT program for your installation. 

After you type RUN SY:$BUILD, BUILD presents you with a sequence of 
dialogue questions. They are duplicated here but their explanations are con- 
tained in the previously mentioned sections. 

SYSTEM BUILD <N0> ? © 

SOURCE INPUT DEVICE <SY:> ? © 

LIBRARY OUTPUT DEVICE <SY:> ? © 

TARGET SYSTEM DEVICE <SYO:> ? © 

LIBRARY ACCOUNT <Clf2]> ? © 

CONTROL FILE IS ? SORT 

DID YOU SYSGEN IN RSX DIRECTIVES AND RESIDENT LIBRARIES (NO)- ? 

Respond to the first five questions as your system requires. To the CONTROL 
FILE IS question you must type SORT. BUILD answers this particular 
response by printing the last question listed above. The response to this 
question determines which version of the SORT program is built on your 
system. If you answered YES to both the RSX DIRECTIVES and RESIDENT 
LIBRARIES configuration questions (Table 1-11) during the system genera- 
tion process, then you may type YES in response to this question. Your YES 
response installs the SORT program which is able to use the RSX monitor 
emulator and resident library features. This version of the SORT program 
processes files more efficiently than the one that does not use them. If you did 
not generate both of these features (generating just one of them is not 
enough), you must press LINE FEED to accept the NO default response. The 
NO response tells BUILD to install the version of the SORT program that 
does not utilize either the RSX monitor emulation or resident library features. 

6.8 Building Optional Software 

If your system is to support any optional software, such as COBOL, 
FORTRAN, or RPG II, build that software after adding the requisite run- time 
system support. To obtain the build procedures, consult the installation guide 
for the software you plan to include. The documentation should include infor- 
mation on patching the software. 

After building and patching the optional software, proceed to the next section 
to create the system message and start-up control files for your system. 

6.9 Create System Message and Start-up Control Files 

Now you can run PIP.SAV or an editor and create the required message or 
start-up control files. For information about PIP, refer to the RSTS/E System 
User's Guide. For information about editors, refer to the appropriate editor 
manual. The following five sections describe the procedures to follow when 
creating these files and contain references to further descriptions of the use 
and contents of the files. 

6.9.1 System Message File NOTICE.TXT 

The system prints the file NOTICE.TXT when you successfully log into the 
system as described in the RSTS/E System User's Guide. In this manner, you 
can relay to users information concerning operation of the installation or 
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changes or addition^ to the system. Before creating your own NOTICE.TXT 
file, you can print the sample file in the library on the console terminal. The 
following example illustrates the procedure: 



RUN $PIP 
*$NOTICE.TXT 

NELCOME TO RSTS/E M7 4 TIME SHARING 



You can create a tailored NOTICE.TXT file to replace the sample file by 
using the following procedure. 



*SY:*NOTICE«TXT=KB: 
HOURS OF OPERATION ARE: 

MON-SAT 8 AM TO 5 PM 

EMENINGS AND SUNDAYS BY REQUEST 



£trl/Z) 
* 



The CTRL/Z at the end of the text file is necessary. It signals the end of the 
text, closes the file properly, and returns control to the PIP program as indi- 
cated by the asterisk (*) character. The system manager can update the file as 
needed. 

6.9.2 System Help File HELP.TXT 

When you type HELP at a logged-out terminal, the system prints the file 
HELP.TXT. You can print the sample file stored in the system library by 
typing the following command string. Note that this example assumes that 
the PIP program is still running from the previous procedures. 

*$HELP.TXT 

TO GET ON-LINE AND USE RSTS/E » FOLLOW THE 
INSTRUCTIONS FOUND IN THE 
RSTS/E SYSTEM USER'S GUIDE, 



If the text is satisfactory, but you need to add some local information, use the 
append feature of the PIP program, delete the old file, and rename the new 
file to set the proper protection code. 

*SYs$HELP.TXT<aO> = SY:*HELP.TXT »KB: 

ASK RALPH FOR A PROJECT-PROGRAMMER 
NUMBER AND PASSWORD, 

EtrDZ) 

You can replace the sample HELP.TXT file by using a comm&nd string 
similar to the one shown in Section 6.9.1. 
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6.9.3 Control Files START.CTL and CRASH.CTL 

The INIT.BAC (or INIT.TSK) system program requires two control files 
whenever it initializes the RSTS/E system for time sharing. The use and 
content of both of these files are explained in the RSTS/E System Manager's 
Guide. A sample file is provided on the distribution medium for each of these 
two control files. Being samples only, they may not work on your system and 
may need to be replaced or edited. The procedures described here show how to 
print the sample files and how to replace them with versions created to suit 
the needs of your installation. 

These two control files must contain the information required to properly 
initialize the system for time-sharing operations. Before you attempt to mod- 
ify or replace the contents of the example files, DIGITAL strongly recom- 
mends that you become thoroughly familiar with the information presented in 
the RSTS/E System Manager's Guide. 

The first and second commands in the following example cause the system to 
print the sample CRASH.CTL and START.CTL files. The third and fourth 
commands cause the system to replace the sample files with the files typed at 
the terminal. 

*$START,CTL 

(SAMPLE FILE IS PRINTED.) 

**CRASH.CTL 

(SAMPLE FILE IS PRINTED,) 

*SYO:*START,CTL=KB: 

(TYPE NEW MERSION. ) 



£trl72 

*SYO:$CRASH.CTL=KB: 
(TYPE NEW MERSION. ) 

When you perform the preceding procedures, the system replaces the sample 
file in the system library with the versions typed. Be sure to replace the 
START.CTL and CRASH.CTL files on the system disk (SYO:). 

The sample START.CTL and CRASH.CTL files use the following indirect 
command files: 

1. RTS.CMD installs auxiliary run-time systems. 

2. TTY.CMD sets terminal characteristics. 

3. SPOOL.CMD initializes spoolers. 

4. CCL.CMD defines CCL commands. 

5. ANALYS.CMD analyzes crash dumps. 

6. CLEAN.CMD logically cleans disks. 

Edit these files as your installation requires, following the descriptions pre- 
sented in the RSTS/E System Manager's Guide. 
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6.9.4 Terminal Speed Characteristics File TTYSET.SPD 

There are some circumstances when you must create the optional terminal 
speed characteristics file, TTYSET.SPD, to set terminal speed characteristics 
at the start of each time-sharing session. Its use and contents are explained in 
the RSTS/E System Manager's Guide. Refer to that document for further 
instructions. 

6.9.5 Standard Account File ACCT.SYS 

You can use the REACT system program to create a large number of user 
accounts automatically. To use this feature, create the file ACCT.SYS in the 
system library. The contents of the ACCT.SYS file is explained in the 
RSTS/E System Manager's Guide. The sample ACCT.SYS file is copied by 
the BUILD program from the distribution medium. You can print and replace 
this sample file by performing the following procedures. Note that DIGITAL 
suggests that you make entries in ACCT.SYS to create a privileged and a 
nonprivileged account for yourself and create auxiliary accounts associated 
with the \,#, &, and % characters. Specify a privileged protection code for the 
file so this sensitive data will be erased when the file is deleted or replaced. 

*$ACCT » SYS 

(THE SAMPLE FILE IS PRINTED,) 

*SY : $ ACCT , SYSU 88 > = KB : 
(TYPE NEW VERSION, ) 



READY 



The new version of ACCT.SYS replaces the sample ACCT.SYS in the system 
library. The PIP system program run terminates. Proceed to Section 6.10 to 
create the user accounts. 



6.10 Creating User Accounts 



Run the REACT system program and use the STANDARD function to create 
the user accounts in the MFD of the system disk. Refer to the RSTS/E System 
Manager's Guide for a description of the REACT system program. The follow- 
ing example illustrates the method used to create the user accounts from 
information in the ACCT.SYS file. 

RUN $REACT 

REACT U7.0 RSTS U7,0 TIME SHARING 

SYSTEM ACCOUNT MANAGER 

FUNCTION? STANDARD 

ALL ACCOUNTS IN ACCOUNT FILE ARE NOW ENTERED 

FUNCTION? @rl7D 

READY 

REACT prints an identification message and a request for a function. If you 
type STANDARD or S, the REACT program creates user accounts from infor- 
mation in the ACCT.SYS file. When the standard function is completed, 
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REACT prints an advisory message and reprints the FUNCTION request. 
Type CTRL/Z to terminate REACT. 

At this point, you have built the system and have made the RSTS/E system 
fully operational. To ensure that you have the correct run- time system in- 
stalled as the default run-time system and also to ensure that the 
START. CTL control files are functional, shut down the system. Section 6.11 
contains a description of these procedures. 

6.11 Shut Down System, Specify Default Run-Time System, 
and Create Recovery IVIedia 

The procedure that you use to shut down the system depends on which run- 
time system you have selected for your default during time-sharing opera- 
tions. If you selected BASIC-PLUS or RSX, follow the shutdown procedures 
described in Step la. Perform the procedures in Step lb if BASIC-PLUS-2 
will be your default run-time system. 

1. Shut down the system. 

a. Follow these instructions to shut down a system using BASIC-PLUS or 
RSX as the default run-time system. 

Type RUN $SHUTUP, to which SHUTUP responds with its identifica- 
tion header line: 

SHUTUP 1^7,0 RSTS U7 . TIME SHARING 

Immediately after the header line appears, SHUTUP presents you with 
a sequence of dialogue questions. At this point refer to the RSTS/E 
System Manager's Guide for a complete explanation of the SHUTUP 
program. When you have successfully completed the SHUTUP opera- 
tion, go to Step 2. 

b. Follow this sequence of instructions to shut down the system if you 
selected BASIC-PLUS-2 as the default run-time system for your time- 
sharing operations. In order for SHUTUP to succeed in bringing the 
system down, it must be run under the system default run-time sys- 
tem. The version of SHUTUP that you have just built runs under the 
BASIC-PLUS-2 Run-Time System. Therefore, you create a temporary 
version of SHUTUP which runs under RSX, which is the current sys- 
tem default RTS. 

>RUN $SHUTUP.RSX (E) 

Type RUN $SHUTUP.RSX, then press RETURN in reply to the RSX 
angle bracket prompt. For a complete description of the SHUTUP 
procedures, refer to the RSTS/E System Manager's Guide. Continue at 
Step 2. 

2. Perform this step if your system default run-time system is not set correct- 
ly. That is, it is temporarily set to RSX and you really want it to be 
BASIC-PLUS-2. To change your default run- time system to 
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BASIC-PLUS-2, you must bring the system down (as you have already 
done in Step 1) and use the DEFAULT option to install BASIC-PLUS-2 
(BP2C0M) as you default RTS. Perform these steps: 

a. Respond to the OPTION: prompt by typing DEFAULT, then press 
RETURN. You are invoking the DEFAULT option to change your 
default run-time system from RSX to BASIC-PLUS-2. Since you have 
already used the DEFAULT option to set your system defaults, you 
can press LINE FEED to each question except the RUN-TIME 
SYSTEM question. To this question you must answer BP2C0M. After 
you have answered that question, press LINE FEED until you are back 
to the OPTION: prompt. 

b. Go to Step 3 to create a recovery medium for your installation. 

3. For your protection, you should create a system recovery medium. By 
using the SAVE option of the SAVE/RESTORE program while you are 
running under INIT.SYS, you can create a copy of the generated system. 
Refer to Section 3.16 of this manual for a brief description of SAVE/ 
RESTORE, then go to the RSTS/E System Manager's Guide for a more 
detailed discussion of this operation. 

6.12 Start Time Sharing, Verify System Control Files, and 
Store Distribution and Recovery Media 

Follow these steps to complete the generation of your system: 

1. Start Time Sharing. After you shut down the system and create the sys- 
tem recovery media using the SAVE/RESTORE program, you can bring 
the system up again by typing START in response to the INIT OPTION: 
prompt. Terminate this response by pressing RETURN and you are ready 
to function under your system default run-time system. Proceed to Step 2. 

2. Verify System Start-Up Control Files. When you start time sharing, the 
system prints on the system console (KB:) any errors that it encounters in 
the system start-up control files that you may have created in Section 6.9. 
If you altered the control files and they no longer run properly, correct 
these control file errors by using a text editor. After you apply the changes 
to the incorrect control files, you must run SHUTUP again to shut down 
the system, then restart the system for time sharing. If the system does 
not print any more error messages, you applied the correction successfully 
and are ready for time sharing. Proceed to Step 3. 

3. Store Distribution and Recovery Media. For your protection place your 
distribution and recovery media in a secure location. The recovery media 
should be protected since it can replace the system disk if your system 
disk becomes corrupt. Keeping the distribution media available but in a 
safe place ensures that you will be able to reproduce your system disk 
when necessary. 
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Chapter 7 

Generating RSTS/E Software During Time Sliaring 



You can generate additional RSTS/E V7.0 Monitors and/or BASIC-PLUS 
Run-Time Systems on-line during time sharing on a previously generated 
V7.0 system. These files can replace the existing versions or can be retained on 
the system disk for occasional use. To generate a monitor or run -time system, 
first ensure that the necessary system generation files are available and (when 
generating a run-time system) that sufficient contiguous space exists on the 
system disk. Next, answer the configuration questions and start the batch 
control file following essentially the same procedures as described in Chapter 
4. When the batch run terminates, the monitor and/or run-time system gener- 
ation is complete. You can then tailor (and install if necessary) the monitor 
and/or make the run- time system available for use. 



7.1 F'reparing for On-Line Generation 

Before you can begin to generate a monitor or BASIC-PLUS Run-Time 
System on-line, the public disk structure must contain the system generation 
files and RTll must be added as a run -time system. A pseudo keyboard must 
also be available. In addition, ensure that the system disk contains enough 
contiguous space for the run-time system or monitor file. 

7.1.1 Finding Contiguous Space for BASIC-PLUS 

Run-time system files must occupy contiguous disk space. Therefore, you 
should ensure that sufficient contiguous space exists on the system disk before 
you generate an additional BASIC-PLUS Run-Time System. If you previ- 
ously allocated extra contiguous space as a dummy or extra-large file, you can 
simply delete or reduce the size of that file. If you did not originally plan extra 
contiguous space, you can use a BASIC-PLUS OPEN statement with the 
contiguous MODE specification to open a file of the approximate size. If the 
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system executes the statement without error, the space exists. If the state- 
ment fails, you must delete some files or transfer some files to other media in 
order to free contiguous disk space. You can then begin to generate the 
BASIC-PLUS Run-Time System. 

7.1.2 Obtaining the System Generation Fiies 

On-line generation of the monitor or BASIC-PLUS requires that the files 
SYSGEN.SAV, SYSBAT.SAV, MACRO.SAV, CREF.SAV, PIP.SAV, 
LINK.SAV, SILUS.SAV, HOOK.SAV, and ERR.STB be in the system 
library account [1,2]. The CREATE batch stream copies these files from the 
distribution medium to the SYSGEN system disk during the initial system 
generation. 

If the Target system was written on a system tape or on a disk other than the 
SYSGEN disk, all the files may not be available on the system disk. Ascertain 
whether the files exist on the system disk. If not, follow the procedures in 
Chapter 2 to mount the distribution medium. Use the MOUNT command to 
logically mount the distribution disk read only. Then use UTILTY to add 
RTll as a run-time system. The following is an example of this procedure: 

RUN $UTILTY 

UTILTY 1^7.0 RSTS U7.0 *TIME SHARING* 
#ADD RTll 

Ready 

Follow the procedures in Chapter 4 to run the CREATE batch stream. This 
batch stream copies the remaining required files to the system disk under the 
logged-in account and chains to SYSGEN.SAV, mentioned above, which asks 
the configuration questions. 

If the Target system was output to the SYSGEN system disk during the 
previous system generation and you specified NO to the DELETE FILES 
question, the files remained on the disk. In this case, you need not recopy 
them. You must, however, add the file RTll.RTS as a run -time system. Run 
the UTILTY program and use the ADD command to do so. You can then 
simply type the command RUN $SYSGEN, which runs the program 
SYSGEN.SAV, as in the following example. 

RUN $SYSGEN 
**12-MAY-79## 

Besinninsf of RSTS/E system feneration. 

Questions come in 1 o n a and short forms. 
If you are familiar with them* answer 
" S " for short? otherwise* answer " L " for 
1 n ^ ^ f r m . 

If you did specify YES to the DELETE FILES question; you cannot specify 
SY: as the distribution media during the on-line SYSGEN, but must then 
specify and physically mount the distribution medium. 
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7.2 Generating the Monitor or BASIC-PLUS Run-Time System 

Answer the configuration questions to include the features required by the 
monitor and/or run-time system. The SYSGEN program asks a subset of the 
configuration questions if you are generating only a monitor or a run-time 
system. When generating a monitor or run- time system for an existing system 
disk, be sure to assign to the new file a different name from the installed file. 
If necessary, you can generate a monitor or run-time system for a new Target 
medium. 

When you have answered all the configuration questions, type RUN 
$SYSBAT to start the batch process. When the execution of the batch file is 
complete, the new monitor or run -time system resides in account [0,1] or you 
can have the output go to any account on the Target system disk. 

7.3 Tailoring a New iVIonitor 

After the batch process ends, you can shut down the system and tailor the new 
monitor whenever it is convenient to do so. To tailor and install the monitor, 
follow the procedures in Sections 5.2 through 5.7. If the monitor runs on an 
existing system disk, you may not need to re-allocate system files. List the file 
status table (using the LIST suboption of the REFRESH initialization option) 
to ascertain any necessary changes. 

7.4 Preparing the New Run-Time System for Use 

You can use the new BASIC-PLUS Run-Time System as an auxiliary run- 
time system or as the system default. 

To use the new BASIC-PLUS Run-Time System as an auxiliary run-time 
system, run the UTILTY program. Issue the ADD command to add the run- 
time system for use under RSTS/E. 

To install a new default run-time system, shut down the system. Use the 
REFRESH option (Section 3.8) to delete the current default run-time system 
(if you do not plan to use it again). Next, use the DEFAULT option (Section 
3.9) and specify the new run-time system as the default. Finally, use the 
START option (Section 3.10) to start time sharing with the new default run- 
time system. 

The new default run-time system needs a new system library. To create a new 
library, log into a privileged account and use the BUILD program. BUILD 
allows you to create the library on a public or private disk. Physically and 
logically mount the output disk, then physically mount the first volume of the 
system library distribution kit. Write-protect this volume. If the distribution 
medium is disk, use the MOUNT command (including the /RO switch) to 
logically mount the disk. Then type RUN $BUILD to run the BUILD pro- 
gram. Refer to Chapter 6 for information on the BUILD procedure. 

l^he BUILD COMPLETE and READY messages signal the end of the BUILD 
procedure. 
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Appendix A 

System Generation Error i\/lessages 



A.1 Initialisation Code Error Messages 

The RSTS/E system initialization code routines make many checks to ensure 
the consistency of system structures. InitiaHzation routines compare existing 
structures with their definitions and with references in other parts of the 
system. The checks must be successful; if not, the routines detect a consist- 
ency error, which indicates that the system is corrupted. 

The initialization routines may also encounter errors while attempting to 
execute initialization options. The error text for many of these errors is 
preceded by the message FATAL RSTS/E SYSTEM INITIALIZATION 
ERROR. The initialization code prints a descriptive error message and re- 
turns to the OPTION: prompt. If such an error occurs, follow the error recov- 
ery procedures in Table A-1. If these procedures are unsuccessful, consult 
your DIGITAL Software Support Specialist. 

For many of the errors, no recovery procedures exist. If such an error occurs, 
you should submit a Software Performance Report (SPR) as noted in the 
recovery procedures column for that error message. 

Table A-1: Initialization Code Error Messages 



Message and Recovery Procedure 



ACCOUNT CI »2] MISSING FROM OUTPUT DISK 

Reinitialize the disk as a system disk and create the library account. 

BAD CO »n DIRECTORY 

Reboot the system disk and retry the operation. If the retry fails, use 
DSKINT to reinitialize the disk. 

13ADB»SYS NOT FOUND ~ RESULTS UNPREDICTABLE 

Reboot the system disk and retry the operation. If the retry fails, use 
DSKINT to reinitialize the disk. 
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Table A-1: Initialization Code Error Messages (Cont.) 



Message and Recovery Procedure 



BUFFtSYS NOT FOUND OR TOO SMALL-DECTAPE DISABLED 

Warning message only. Shut down the system and use REFRESH to 
create the file at the required size. 

CANNOT REFRESH THIS DISK 
Reinitialize the disk. 

CANNOT START NITH THIS SNAP MAX AND MEMORY TABLE 

Use DEFAULT to change the swap max and/or memory allocation 
table. 

CLUSTER 1 (REQUIRED FOR MFD) CONTAINS A BAD BLOCK 

If the pack cluster size for the disk is greater than the device cluster 
size, use DSKINT to reinitialize the disk with a lower pack cluster size. 
If the error recurs, use a different disk. 

CLUSTER ALLOCATED TO CP »PN] f ilnafruext IS NOT ON A PACK 
CLUSTER BOUNDARY 

CLEAN asks whether to delete the file, then confirms your response. 

CP ^PN] CLUSTER MAP IN UFD DISAGREES NITH MFD 

CLEAN asks whether to zero the account and confirms your response. 

DEFAULT RTS HAS INVALID SIZE PARAMETERS 
Regenerate the run-time system. 

DEFAULT RTS NOT FOUND OR INVALID 

Ensure that a valid run-time system is on the system disk. Regenerate 
the run- time system if necessary. 

DEMICE XKS DOES NOT INTERRUPT - DEMICE DISABLED 

Use HARDWR to set the correct vector address for xx: or call the 
DIGITAL field service engineer. 

DEMICE ERROR NHEN TRYING TO BOOTSTRAP DEMICE 

Ensure that the device is on-line and ready. If the error recurs, try a 
different device. 

DEUICE HUNG OR NRITE-LOCKED 

Ensure that the device is on-line and ready. If the error recurs, try a 
different device, 

DIRECTORY ENTRY FOR CPtPN] filnafTuext CONTAINS PACK 
CLUSTER NUMBER NHICH IS TOO BIG 

CLEAN asks whether to delete the file and confirms your response. 

DIRECTORY ERROR DETECTED IN RDB 
Reinitialize the disk. 

DIRECTORY ERROR - FILE NOT FOUND 
Reinitialize the disk. 
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Table A-1: Initialization Code Error Messages (Cont.) 



Message and Recovery Procedure 



CO ^1] DIRECTORY NOT FOUND 
Reinitialize the disk. 

DISK BLOCK (REQUIRED FOR BOOTSTRAPS) IS BAD 
Reinitialize the disk. If the error recurs, use a different disk. 

DISK ERROR DURING DSKINT BUILD PHASE 

Reinitialize the disk. If the error recurs, use a different disk. 

DISK HUNG OR DATA ERROR DURING OVERLAY 

Ensure that the device is on-line and ready. If the error recurs, try a 
different device. 

DISK STRUCTURE IS IRREMOCABLY CORRUPT 
Reinitialize the disk. 

DOUBLY ALLOCATED BLOCK FOUND AT DEMICE CLUSTER nn, THE 
BLOCK IS ALLOCATED TO CPfPn] filriam»eKt AND Cptpn] 
f i 1 n a m ♦ e K t 

CLEAN lets you choose the file to delete, then confirms your response. 

DRIME NOT READY s 

Ensure that the disk drive is on-line and READY. Press LINE FEED to 
retry the operation. Type any other character to abort the operation. 

DSKINT ERROR - ATTEMPT TO FORMAT UNFORMATTABLE DISK 
Submit an SPR. 

DSKINT OR SYSGEN ERROR - DSKINT ALLOCATION FAILURE 
Submit an SPR. 

EOF READING INIT^SYS 
Submit an SPR. 

ERR FILE INUALID 

Copy the file ERR, ERR from the distribution medium to the system 
disk and use the DEFAULT option to install ERR.ERR as the system 
default. 

ERR FILE NOT FOUND 

Copy the file ERR.ERR from the distribution medium to the system 
disk and use the DEFAULT option to install ERR.ERR as the system 
default. 

ERROR DETECTED NHILE READING ERROR RECORD SECTOR #ri 
Warning message only. Error occurred during reading of factory error 
records. Disregard the error message. 

ERROR ~ KB INTERFACES OUT OF SEQUENCE 

Regenerate your monitor. If the problem recurs, submit an SPR. 
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Table A-1: Initialization Code Error Messages (Cont.) 



Message and Recovery Procedure 



ERROR-NO SETUP FOR DISK x x : 

Regenerate your monitor. If the problem recurs, submit an SPR. 

ERROR-UNKNONN DISK xx: 

Regenerate your monitor. If the problem recurs, submit an SPR. 

EXCESSIME BAD CLUSTERS 

If you need to use the current disk, use DSKINT to increase the pack 
cluster size. If the error recurs, use a different disk. 

FATAL DISK ERROR DURING CONTROL RESET 

Retry the DSKINT. If the error recurs, call the DIGITAL field service 
engineer to repair the disk drive. 

FATAL ERROR - NO SMALL BUFFERS LEFT 

Regenerate the system and configure more small buffers. 

FATAL I/O DURING OVERLAY 

Ensure that the device is on-line and ready. If the error recurs, try a 
different device. 

XXX FILE NOT FOUND NHEN REMOUING IT 

Warning message only, xxx is SIL, RTS, or ERR. The initialization 
code did not find a file when trying to make it deletable. 

CP »PN] f i Inam* ext HAS A BAD BLOCK 

CLEAN asks whether to delete the file and confirms your response. 

CP »PN] f ilnafTwext HAS FIRST DCN OUT OF RANGE 

CLEAN asks whether to zero the account and confirms your response. 

CP *PN] f 11 nam ♦ex t HAS INMALID ACCOUNTING ENTRY LINK 
CLEAN asks whether to delete the file and confirms your response. 

filnafiwext HAS ILLEGAL FORMAT AND CANNOT BE COPIED 

Submit an SPR if DIGITAL supplied the file on the distribution medium. 
Regenerate your system monitor if the system generation process cre- 
ated the file. 

FORMATTING FAILURE". 

Press LINE FEED to retry. Type anything else to abort the DSKINT 
and return to the OPTION: prompt. Ensure that the disk drive is write 
enabled. This error may indicate a bad disk pack or a bad disk drive. 

[P »PN3 HAS A BAD BLOCK 

CLEAN asks whether to delete the account and confirms your response. 

CPfPN] HAS HOLES IN CLUSTER MAP 

CLEAN asks whether to zero the account and confirms your response. 

CPtPN] HAS INCONSISTENT CLUSTER MAPS 

CLEAN asks whether to zero the account and confirms your response. 
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Table A-1: Initialization Code Error Messages (Cont.) 



Message and Recovery Procedure 



CP fPHl HAS INMALID CLUSTER SIZE 

CLEAN asks whether to delete the account and confirms your response. 

ILLEGAL CONTROLLER FOR TU5S 
Submit an SPR. 

ILLEGAL INTERFACE INDEX nn 

Regenerate your monitor. If the error recurs, submit an SPR. 

INIT BUG - BAD DISK INDEX 
Submit an SPR. 

INIT BUG - CAN'T ALLOCATE FILE 2ND TIME 
Submit an SPR. 

INIT BUG - CAN'T CHECK PARITY 
Submit an SPR. 

INIT BUG - CAN'T FIND CO »!] AGAIN 
Submit an SPR. 

INIT BUG - CAN'T FIND FILE TO DELETE 
Submit an SPR. 

INIT BUG - CLEAN FAILED TO FIND ALLOCATION ERROR 
Submit an SPR. 

INIT BUG - DIDN'T GET SAME CLUSTER 2ND TIME 
Submit an SPR 

INIT BUG - DIDN'T GET SAME FILE CLUSTER 2ND TIME 
Submit an SPR. 

INIT BUG - DON'T KNON HOW TO START 
Submit an SPR. 

INIT BUG - FAILED TO CREATE FILE 
Submit an SPR. 

INIT BUG - FAILED TO FIND FILE AGAIN 
Submit an SPR. 

INIT BUG - FAILED TO FIND FILE JUST CREATED 
Submit an SPR. 

INIT BUG - FILE EXISTS WHEN TRYING TO CREATE 
Submit an SPR. 

INIT BUG -xxx-file tvpe FILE NOT FOUND 2ND TIME 
Submit an SPR. 

INIT BUG - XXX ~ FILE NOT FOUND WHEN REMOMING IT 
Submit an SPR. 
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Table A-1: Initialization Code Error Messages (Cont.) 



Message and Recovery Procedure 



INIT BUG - FILE SIZE COMPUTED NRONG 

Ensure that the system device you are using contains a vaHd system. If 
so, submit an SPR. 

INIT BUG - FLOAT TABLE ERROR 
Submit an SPR. 

INIT BUG - INSTALL NOT SYNCHRONIZED at kxkkxk 
Submit an SPR. 

INIT BUG - NO SATT,SYS AT NIPEOUT TIME 
Submit an SPR. 

INIT BUG - NO UFD FOUND IN CREATE 
Submit an SPR. 

INIT BUG - RNB TO WRONG DISK 
Submit an SPR. 

INIT BUG - SATTtSYS NONEXISTENT AT TIME OF NOMP 
Submit an SPR. 

INIT BUG - SET NEN TABLE TOO SMALL 
Submit an SPR. 

INIT BUG - UNKNOWN BAE DEUICE 
Submit an SPR. 

INIT BUG - START LINKED TOO LOW 
Submit an SPR. 

INIT LINK BUG - DEFBUF NOT ALIGNED 
Submit an SPR. 

INIT LINK BUG - DSTBL TOO LOW 
Submit an SPR. 

INIT LINK BUG - FIBUF NOT ALIGNED 
Submit an SPR. 

INIT LINK BUG - INSBUF NOT ALIGNED 
Submit an SPR. 

INIT LINK BUG - SATBUF NOT ALIGNED 
Submit an SPR. 

INIT. SYS NOT FOUND - RESULTS ARE UNPREDICTABLE 

Reboot the system disk and retry the operation. If the retry fails, reini- 
tialize the disk. 

INPUT FILE MISSING FROM SYSTEM DEVICE 

Retry the procedure that generated the error. If the error recurs, submit 
an SPR. 
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Table A-1: Initialization Code Error Messages (Cont.) 



Message and Recovery Procedure 



INSTALLED MONITOR DOES NOT SUPPORT THIS SYSTEM DISK 
Regenerate a monitor that supports the system disk or use the COPY 
option to transfer the monitor to a disk it supports. 

INSTALLED SIL INVALID 

The installed SIL is invalid as a monitor SIL. Use the INSTALL option 
to install a valid SIL. 

INVALID DATA IN ERROR RECORD SECTOR *ri 

Warning message only. The error occurred during reading of factory 
error records. Disregard the error message. 

INMALID RETRIEVAL ENTRIES FOR FILE Up »pri] f 11 nam ♦ex t - 
FIXED BY CLEAN 

Warning message. CLEAN truncates the file. 

I/O TO UNOPENED FILE 
Submit an SPR. 

CP »PN] IS NOT A MALID ACCOUNT NUMBER 

CLEAN asks whether to delete the account and confirms your response. 

MFD NAME ENTRY CONTAINS A BAD LINK* CLEAN WILL DELETE 
ALL Cl»n FILES AND ALL ACCOUNTS BEYOND Cp^pn] 
f i 1 n a M ♦ e X t 

CLEAN confirms your response. 

MONITOR SIL CHANGED - REINSTALL IT 

Use the INSTALL option to install the monitor SIL. 

MONITOR SIL NOT FOUND 

Use the INSTALL option again to install the SIL. If the error recurs, 
submit an SPR. 

MT f MS » MM ERROR OR INMALID FORMAT ON TAPE 

Ensure that the tape drive heads are clean and correctly aligned. If the 
error recurs, try using a different drive. 

NO LIBRARY ACCOUNT ON THIS DISK 

Reinitialize the disk and create a library account. 

NO ROOM FOR DIRECTORY ON OUTPUT DISK 

Delete files or reinitialize the disk to create sufficient contiguous space 
on the disk for the file. Or use a different disk. 

NO ROOM FOR FILE ON OUTPUT DISK 

Delete files, reintialize the disk to create sufficient contiguous space on 
the disk for the new file, or use a different disk. 

NO ROOM FOR 2 JOBS IN SNAPtSYS 

Use REFRESH to increase the size of SWAP.SYS so that it can ac- 
comodate two jobs of size SWAP MAX. 
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Table A-1: Initialization Code Error Messages (Cont.) 



Message and Recovery Procedure 



NOT ENOUGH ROOM IN LOW MEMORY FOR MONITOR 
Generate a smaller monitor. 

NOT ENOUGH ROOM IN MEMORY FOR RUN TIME SYSTEM 
Generate a smaller monitor or run-time system. 

ONE OR MORE SYSTEM FILES MISSING 
Reinitialize the disk. 

OPTION ATTEMPTED DURING BOOTSTRAP PHASE 

Rebootstrap the system and retry the operation. If the retry fails, sub- 
mit an SPR. 

OPTION NOT AVAILABLE 

The option you requested is not available until you bootstrap the sys- 
tem disk. 

OUTPUT DISK IS DIRTY - CANNOT PROCEED 

Use REFRESH to clean the disk or use DSKINT to reinitialize the disk. 

OUTPUT DISK IS NOT A SYSTEM DISK 
Reinitialize the disk as a system disk. 

OVERLAY HANDLER IN ERROR 
Submit an SPR. 

OUR NOT IN SIL 

Regenerate the monitor. 

PACK CLUSTER SIZE IS NOT 1 » 2 » 4 » 8 » OR IS 
Reinitialize the disk. 

PARITY CSR FOUND* BUT NOT RELATING TO MEMORY 
Call the DIGITAL field service engineer. 

PARITY CSR CONTROLS MORE THAN 31K 
Call the DIGITAL field service engineer. 

PERMANENTLY MAPPED REGION OF MONITOR IS TOO LARGE 

Regenerate to create smaller monitor. Configure fewer small buffers or 
fewer devices. 

PRIORITY OF xk: INTERRUPT ( PRn ) IS TOO HIGH - DEMICE 
DISABLED 

Call the DIGITAL field service engineer to install the device correctly. 

QUESTION ATTEMPTED DURING AUTO-RESTART 

If the system disk needs cleaning, start the system by typing START or 
LINE FEED, thereby cleaning the disk. If any other problem occurs, 
submit an SPR. 
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Table A~l: Initialization Code Error Messages (Cont.) 



Message and Recovery Procedure 



REQUESTED DISK DRIME NOT FOUND 
Request a disk that is on the system. 

REQUIRED MODULE xxkxxx HAS INMALID LENGTH 

Regenerate the monitor. If the error recurs, submit an SPR. 

REQUIRED MODULE xxxxxx HAS INMALID TRANSFER ADDRESS 
Regenerate the monitor. If the error recurs, submit an SPR. 

REQUIRED MODULE xxxxxx HAS WRONG LOAD ADDRESS 
Regenerate the monitor. If the error recurs, submit an SPR. 

REQUIRED MODULE xxxxxx IS IMPROPERLY LINKED 
Regenerate the monitor. If the error recurs, submit an SPR. 

REQUIRED MODULE xxxxxx IS MISSING A REQUIRED SYMBOL 
Regenerate the monitor. If the error recurs, submit an SPR. 

REQUIRED MODULE xxxxxx NOT FOUND IN SIL 

Regenerate the monitor. If the error recurs, submit an SPR. 

REQUIRED MODULE xxxxxx OUT OF SEQUENCE IN SIL 
Regenerate the monitor. If the error recurs, submit an SPR. 

REQUIRED MODULE xxxxxx TOO LARGE 

Regenerate the monitor. If the error recurs, submit an SPR. 

REQUIRED MODULE xxxxxx TOO SMALL 

Regenerate the monitor. If the error recurs, submit an SPR. 

REQUIRED SYMBOL xxxxxx MISSING FROM MONITOR 
Regenerate the monitor. If the error recurs, submit an SPR. 

RSTS/E REQUIRES AT LEAST aOK NORDS OF MEMORY 
Your configuration is too small for the system. 

RSTS/E REQUIRES EIS! 

Correct the hardware configuration to include EIS instructions. 

RSTS/E REQUIRES A CLOCK ! 

Correct the hardware configuration to include a KWllP or KWllL 
clock. 

RSTS/E REQUIRES MEMORY MANAGEMENT HARDWARE! 

Correct the hardware configuration to include a memory management 
unit. 

SATT»SYS IS OUER IB BLOCKS LONG 

If the file structure on the disk is sound, submit an SPR. Otherwise, 
reinitialize the disk. 
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Table A-1: Initialization Code Error Messages (Cont.) 



Message and Recovery Procedure 



SATT«SYS NON-EXISTENT AT TIME OF READ 

If the file structure on the disk is sound, submit an SPR. Otherwise, 
reinitialize the disk. 

SATTtSYS NOT FOUND - RESULTS UNPREDICTABLE 

Reboot the system and retry the operation. If the error recurs, reinitial- 
ize the disk. 



filnam,SIL NOT FOUND - PLEASE INSTALL A SIL 

The SIL that you previously installed is not on the disk. 
INSTALL option to install a monitor SIL. 



Use the 



SNAP^SYS NOT CONTIGUOUS OR TOO SMALL 

Use the REFRESH option to create a contiguous SWAP.SYS of the 
correct size. 

SNAP, SYS NOT PRESENT IN CO tl] 

Use the REFRESH option to create SWAP.SYS in [0,1] 

SYMBOL XXKXXK NOT FOUND IN MONITOR SYMBOL TABLE 
Regenerate the monitor. If the problem recurs, submit an SPR. 

SYSTEM DISK DISABLED IN MONITOR 

Use the SET option to enable the system disk device. 

TOO MANY BAE DEVICES 
Submit an SPR. 

TOO MANY BLOCKS IN DEUICE CONFIGURATION TABLE 
Regenerate the monitor. 

TOO MANY XX : CONTROLLERS GENERATED 

Ensure that any edits to CONFIG. MAC are correct. If there are no 
editing errors, regenerate the system. 

TOO MANY RH OR UNIBUS DEVICES 
Submit an SPR. 

TOO MANY SUBLINES FOR nriS 

Ensure that any edits to CONFIG. MAC are correct. If there are no 
editing errors, regenerate the system. 

TOO MANY UNIBUS DEMICES ON THIS 11/70 

First, disable unnecessary devices with HARDWR or SET. If the error 
condition persists, use DEFAULT to lock all memory addresses above 
124K. (The computer runs in 18-bit addressing mode instead of 22-bit 
addressing mode.) If the error condition is present after you lock memo- 
ry, or if the computer has 124K words of memory or fewer, submit an 
SPR. 
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Table A-1: Initialization Code Error Messages (Cont.) 



Message and Recovery Procedure 



TOO MUCH MODIFICATION TO MONITOR REQUIRED 

Regenerate to produce a monitor that is more closely configured to your 
system hardware. 

TU58 DEUTBL PACKET MISSING 
Submit an SPR. 

TNO MAGTAPE UNITS HAUE THE SAME UNIT NUMBERS 

Examine unit switches on magnetic tape drives and ensure that no two 
have the same unit number. 

UFD HAS SIZE TOO LARGE FOR FILE CP»PN] filnam^ext - 
FIXED BY CLEAN 

Warning message only. CLEAN corrects the condition. 

UFD HAS SIZE TOO SMALL FOR FILE CP>PN] filnafruext - 
FIXED BY CLEAN 

Warning message only. CLEAN corrects the condition. 

CO *1] UFD NOT FOUND 
Reinitialize the disk. 

UNABLE TO CREATE REQUESTED FILES(S) 

Delete some files and retry the procedure, or request smaller files. Also, 
try using the FILE suboption of REFRESH to create files one at a time. 

UNEXPECTED OVERLAY TRAP 
Submit an SPR. 

UNEXPECTED TRAP THROUGH THE SECTOR AT nnn* TRAP 
OCCURRED FROM PC = n n n n n n ♦ 
Submit an SPR. 

UNKNOWN DEUICE BOOTED 
Submit an SPR. 

UNKNOWN RH CONTROLLER PRESENT 

Call the DIGITAL field service engineer to correct the hardware 
configuration. 

UNRECOVERABLE DISK ERROR ON xxn: 

Ensure that the disk is mounted and write enabled (if necessary). If the 
disk is properly mounted, this error indicates a fatal disk error. Refor- 
mat and reinitialize the disk, or use a different disk. 

USER-DEFINED ADDRESS FOR DEMICE xxrisNOT FOUND - DEVICE 
DISABLED 

Use HARDWR to set the correct CSR address for xx:, or call the 

DIGITAL field service engineer. 
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Table A-1: Initialization Code Error Messages (Cont.) 



Message and Recovery Procedure 



USING KNUL CLOCK 

Warning message only. The installed SIL's defaults indicate for a 
KWllP clock is preferred, but the KWllP clock is not present. RSTS/E 
uses the KWllL clock instead. 

USING KNllP CLOCK AT LINE FREQUENCY 

Warning message only. The installed SIL is configured for KWllL 
clock; but the KWllL clock is not present. RSTS/E uses the KWllP 
clock instead. 

MECTOR FOR DEVICE kx: (nrinn) ALREADY IN USE - DEMICE 
DISABLED 

Use HARDWR to set the correct vector address for xx:, or call the 

DIGITAL field service engineer. 

NARNING - BAD BLOCK DOUBLY ALLOCATED TO BADB^SYS 
Warning message only. 

NARNING - DON IN BADB»SYS TOO BIG 

Warning message only. The file structure on the disk being cleaned 
appears invalid. 

WARNING**DBn: IS DUAL PORTED* PROCEED WITH CAUTION 
Warning message only. 

NARNING - DON IN BADB,SYS NOT ON PACK CLUSTER BOUNDARY 
Warning message only. 

WARNING - xxK FILE NOT FOUND - PLEASE SET DEFAULTS 

The SIL you are installing specifies a default run -time system or error 
message file that is not present. Use the DEFAULT option to specify a 
valid file. 

WARNING - FILE filnam»ext NOT FOUND WHEN REMOVING OLD 
SIL 

Warning message only. 

WARNING- LINK IN BADB^SYS IS BAD* BAD BLOCKS MAY BE LOST, 
Warning message only. 

WARNING - MAIN MEMORY (cache) DISABLED AT STARTUP, 
RSTS/E WILL NOT USE (cache ) . SYSTEM MAY RUN SLOWLY. 

Warning message only, (cache) is CACHE, CACHE GROUP 0, or 

CACHE GROUP 1. 

WARNING - MAIN MEMORY (cache) IS FAILING REPEATEDLY, 
RSTS/E WILL NOT USE (cache) , SYSTEM MAY RUN SLOWLY, 

Warning message only, (cache) is CACHE, CACHE GROUP 0, or 

CACHE GROUP 1. 
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Table A-1: Initialization Code Error Messages (Cont.) 



Message and Recovery Procedure 


WARNING - 
Warning 

WARNING - 
Warning 
monitor. 


ODT IN THE SIL IS IN AN ILLEGAL FORMAT 
message only. 

SUBLINES FOR xxsARE OUT OF SEQUENCE 

message only, but the system may crash. Regenerate the 



A.2 RT11 Run-Time System Error Messages 

The RTll Run-Time System can generate the errors described in Tables A-2 
and A-3. 

Table A-2: Recoverable RTll Run-Time System Errors 



Message and Meaning 



7ADDR? 

You specified an illegal address with an E, D, or B command. 

?BAD LOAD? 

RTll encountered an error when reading the program into memory. 

?BAD PPN? 

You typed an illegal PPN in response to a LIB or PPN command. 

?BAD START ADDRESS? 

The program start address was odd or out of bounds. 

?FIL NOT FND? 

The specified file cannot be found. 

OCT T I CO 

r r 1 Lc. r 

You specified no filename or an illegal filename with the R, RUN, or 
GET command. 

You typed an illegal command. The command includes an unrecognized 
command, a syntax error in a command string, a command line longer 
than 510 characters, or an attempt to change to an illegal size (2 <size< 
swap max for this job). 

?ILL DEM? 

The command string includes an illegal device name. 

?N0 RESTART? 

You typed the RESTART command, but the program is not restartable. 

?OMR CORE? 

The program is too large to fit into memory. 



(continued on next page) 
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Table A-3: RTU Run-Time System Fatal Execution Errors 



Message and Meaning 



7M-BPT TRAP 

The program issued a BPT instruction, but the job has an illegal vector 
location. 

7M-FP TRAP 

A floating point trap occurred. 

7M-HALT 

The program halted. 

?M-ILL EMT 

The program issued an invalid monitor call. 

?M-IOT TRAP 

The program issued an lOT instruction, but the job has an illegal vector 
location. 

7M-0MLY ERR 

The RTll Run-Time System encountered an error while reading a pro- 
gram overlay. This message may indicate a hardware error. 

7PR0GRAM LOST - SORRY 

An unrecoverable error occurred. The run-time system resets user core 
image. 

7M-T00 MANY OPEN CHANNELS 

The job attempted to open more than 15 channels or attempted to open 
two DECtape files at once. 

7M-TRAP TO a 

The program trapped to the vector at location 4. 

7M-TRAP TO 10 

The program trapped to the vector at location 10. 

7M-TRAP TRAP 

The job issued the TRAP instruction, but the job has an illegal vector 
location. 



A.3 Batch Error Messages 



During the execution of the batch streams associated with CREATE.SAV and 
SYSBAT.SAV, two types of errors may occur. The RTll Run-Time System 
returns most errors. The batch program translates these errors to their 
BASIC-PLUS equivalents and prints the BASIC-PLUS error message text. 
You can find a discussion of BASIC-PLUS error messages in the 
BASIC-PLUS Language Manual. The batch program itself may generate 
several other errors. Table A-4 summarizes these errors. 
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Table A-4: BATCH Error Messages 



Message and Meaning 



CREATE NOT RUN FROM DISTRIBUTION MEDIUM 

The CREATE program can be run only from the distribution medium. 

DEUICE NOT MOUNTED 

The batch stream attempted to dismount a device that was not mounted. 

ERROR CHAINING TO $SYSGEN,SAg 

The CREATE program could not find the $SYSGEN.SAV file. 

ERROR DURING PSEUDO KEYBOARD INPUT 

An error occurred during input to the pseudo keyboard. 

ERROR DURING PSEUDO KEYBOARD OUTPUT 

An error occurred during output to the pseudo keyboard. 

ERROR OPENING OR READING *LOGINtSAM 

The CREATE program could not find the $LOGIN.SAV file on the 
distribution medium, or an error occurred while reading the file. 

ERROR OPENING OR READING SYSGEN»CTL FILE 

The SYSBAT program could not find the SYSGEN.CTL file, or an 
error occurred while reading the file. 

INMALID CARD 

A line contained a command in an incorrect format. 

INMALID SNITCH 

A switch used in the command field or in the specification field is 
undefined or in an incorrect format. 

JOB FAILED TO LOG IN 

The job cannot log in because the LOGIN program or the requested 
account was missing. 

LOGINS HAME NOT BEEN ENABLED 

Logins must be enabled before the batch stream can be processed. 

MOUNT ERROR 

The volume to be mounted was not correct (pack IDs do not match) or 
the device was already in use. 

TOO MANY MOUNTED DEMICES 

The job requested the mounting of more than twelve devices. 

TWO MAGTAPE UNITS HA ME THE SAME UNIT NUMBERS 
TUlG/TElG/TUa5/TU77 

Examine unit switches on magnetic tape drives and ensure that no two 

have the same unit number. 
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Appendix B 

Disk Device Sizes, System IVJodule Sizes, and 
BASIC-PLUS IVIoduie Sizes 



The following table lists the device cluster size and device size (in 256- word 
blocks) for each of the disk devices supported by RSTS/E. 

Table B-1: Disk Device Sizes 



Disk Device 


Device Cluster Size 


Device Size 


RFll 




1024 * (number of platters) 


RS03 




1024 


RS04 




2048 


RK05 




4800 


RK05F 


' . 


4800 for each unit; 2 units 
for each drive 


RLOl 




10220 


RL02 




20460 


RK06 




27104 


RK07 




53768 


RP02 


2 


40000 


RP03 


2 


80000 


RM02 


4 


131648 


RM03 


4 


131648 


RP04 


4 


167200 


RP05 


4 


167200 


RP06 


8 


334400 



B-1 



Table B-2 supplies the approximate memory sizes of software modules on 
RSTS/E. Table B-3 supplies approximate memory sizes for BASIC-PLUS 
modules. By summing the values given, you can estimate the total size of the 
system. 



Table B-2: System Module Sizes 



Module 


Decimal Words 


Comments 


Monitor Options 






FIP Buffering 


496 




Small Buffers 


16 per buffer 




System-Wide Logical Names 


5 per name 


Up to 50 logical names 
allowed. 


Large Files 


279 




RSX Emulator 


1617 




Resident Libraries 


930 




Data Caching 


1104 




Resident FIP Functions 






Disk Handling (w/o large files) 


1824 




Disk Handling (with large file) 


2068 




Send/Receive 


466 




Simple SYS Calls 


589 




File Delete/Rename 


256 




Login/Attach 


390 




Directory Lister 


605 




Disk Support 






RF Disk 


51 


RFll 


RS Disk 


52 


RS03/RS04 


RK Disk (nonoverlapped) 


108 


RK05/RK05F 


RK Disk (overlapped) 


246 




RL Disk (nonoverlapped) 


316 


RL01/RL02 


RL Disk (overlapped) 


382 




RM Disk (nonoverlapped) 


299 


RK06/RK07 


RM Disk (overlapped) 


386 




RP Disk (nonoverlapped) 


135 


RP02/RP03 


RP Disk (overlapped) 


242 




RR Disk (nonoverlapped) 


332 


RM02/RM03 


RR Disk (overlapped) 


455 




RB Disk (nonoverlapped) 


332 


RP04/RP05/RP06 


RB Disk (overlapped) 


455 




Queue Optimize 


45 


For moving head disks. 


ECC Module 


99 


For RM, RR or RB disks. 


UNIBUS Disk Overhead 


34 


For all but RM02/RM03 and 
RP04/RP05/RP06 disks. 


MASSBUS Disk Overhead 


47 


For RM02/RM03 and 
RP04/RP05/RP06 disks. 


Device Support 






TU16/TE16/TU45A'U77 Tape 


851 


Add 19 per unit for DDB. 


TUlO/TE10ArS03 Tape 


761 


Add 19 per unit for DDB. 
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Table B-2: System Module Sizes (Cont.) 



Module 


Decimal Words 


Comments 


Device Support (cont.) 






TS04 


765 


Add 45 per unit for DDB. 


DECtape 


439 


Add 4 per unit for DDB. 


TU58 


893 


Add 12 per unit for DDB. 


Floppy Diskette 


853 


Add 14 per unit for DDB. 


Pseudo Keyboards 




Add 6 per unit for DDB. 


Paper Tape Reader 


133 


Add 8 per unit for DDB. 


Paper Tape Punch 


133 


Add 8 per unit for DDB. 


Line Printer 


600 


Add 16 per unit for DDB. 


XBuff Line Printer 


672 


Add 16 per unit for DDB. 


CRll/CMll Card Reader 


263 


Add 89 per unit for DDB. 


CDll Card Reader 


274 


Add 89 per unit for DDB. 


Card Decode Table 


128 




DMCll Synchronous 


1200 


Add 24 per unit for DDB. 


Line Interface 






Big Buffer 


48 


For TU16/TE16/TU45 
/TU77 or TUIO/TEIO 
ArS03 magnetic tape, but no 
DECtape. 


Big Buffer 


256 


For DECtape. 


Terminal Option Support 






Terminals 




Add 21 per unit for DDB. 


Echo Control 


238 


Add 4 per unit for DDB. 


Multi-Terminal Service 


166 




2741 Support 


200 


Add 2 per unit for DDB. 


Single Line 


+100 




DHll 


+100 




DZll 


+100 




Code Table 


+128 
per code 


Up to four codes allowed. 



Table B-3: BASIC-PLUS Module Sizes 



Module 


Decimal Words and Description 


Math Packages 

MA2 


2320 

2-word without FIS or FPP 


MA2I 


1993 

2~word with FIS 


MA2F 


1940 

2-word with FPP 


MA4 


3089 

4-word without FIS or FPP 


MA4F 


2310 

4-word with FPP 
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Table B-3: BASIC-PLUS Module Sizes (Cont.) 



Module 


Decimal Words and Description 


Log Functions 

XL2 


336 

2-word log function without FIS or FPP 


XL2I 


336 

2-word log function with FIS 


XL2F 


249 

2-word log function with FPP 


XL4 


475 

4-word log function without FIS or FPP 


XL4F 


317 

4-word log function with FPP 


Trig Functions 

XT2 


324 

2-word trig function without FIS or FPP 


XT2I 


324 

2-word trig function with FIS 


XT2F 


247 

2-word trig function with FPP 


XT4 


419 

4-word trig function without FIS or FPP 


XT4F 


311 

4-word trig function with FPP 


Optional Features 

Common Polynomial 
Calculation 


31 

2-word floating point without FPP 




47 

4-word floating point without FPP 


Matrices (MX) 


943 


String Arithmetic 
(SF) 


990 


Print Using (PU,PX) 


1121 



NOTE 

FPP is compatible with PDP 11/34, 11/45, 11/50, 11/55, 11/60 
and 11/70 processors. FIS is compatible with PDP 11/35 and 
11/40 processors. 
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Appendix C 

Address and Vector Assignments 



The RSTS/E system initialization code performs a hardware configuration 
check each time the system disk (or distribution medium) is bootstrapped. In 
the absence of any information to the contrary, the initialization code as- 
sumes that all devices attached to the UNIBUS have been assigned addresses 
according to the manufacturing standards. The initialization code determines 
interrupt vectors automatically by forcing each supported device to interrupt. 
Although the HARDWR initialization option allows you to declare non- 
standard address and vector assignments, DIGITAL recommends that the 
standard configuration rules be followed whenever possible. 

Several devices have Floating Addresses. This means that the presence or 
absence of any floating address device will affect the assignment of addresses 
to other floating address devices. Similarly, many devices have Floating 
Vectors. According to the standard, interrupt vectors must be assigned in a 
specific sequence and the presence of one type of device will affect the correct 
assignment of interrupt vectors for other devices. Finally, there are many 
options that have fixed addresses and vectors. This appendix presents the 
algorithms for assignment of floating addresses and vectors. It also lists the 
fixed assignments for devices supported by RSTS/E. 



C.1 Floating Addresses 



Currently the floating address devices include the DJll and DHll multi- 
plexers; the DQll, DUll, and DUPll synchronous line interfaces; the 
LKll; the DMCll interprocessor link; the DZll multiplexer and the KMCll 
micro-processor. The following ground rules apply to these devices and future 
floating address devices: 

1. Only new devices will be assigned floating addresses. Devices now in pro- 
duction will keep their old addresses. 

2. Future devices may float both their address and interrupt vectors. 
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3. The floating address space starts at 760010(8) and proceeds upward to 
764000(8). 

4. A gap in the address space (no SLAVE SYNC) impUes that a device does 
not exist. 

5. The first address of a new type device will always be on a 2tN word 
boundary, where N is the first integer greater than or equal to LOG2M and 
M is the number of device registers. 

Number of Registers 

In Device Possible Boundaries 

1 Any Word 

2 XXXXX0,XXXXX4 
3,4 XXXXXO 

5,6,7,8 XXXX00,XXXX20,XXXX40,XXXX60 

9 thru 16 XXXX00,XXXX40 

6. A "gap" of at least one word will be left after each type of device, starting 
on the same boundary the device would start on. Note that the gap must 
be at least one word in length but may be longer than one word. Gap 
length is determined by the boundary on which the next must be ad- 
dressed contiguously. 

Address 760010 is reserved for the first DJll. Since the DJll has four regis- 
ters, additional DJll's are assigned addresses modulo 10 (base 8) immediately 
following the first DJll (i.e., 760010, 760020, etc.). The modulo 10 (base 8) 
address following the last DJll is left empty and is known as the DJll gap. If 
there are no DJll's, the gap is at 760010. If there is one DJll, the gap will be 
at 760020. All gaps must be at least one word in length. 

After all DJll addresses and the DJll gap are defined, the address for the 
first DHll can be assigned. DHll's have eight registers which implies a 
modulo 20 (base 8) boundary. The address of the first DHll is the first 
modulo 20 address following the DJll gap. If there are no DJll's (DJll gap at 
760010), the first DHll is assigned address 760020. Similarly, if there is one 
DJll, the DJll gap will begin at 760020 and the next available modulo 20 
boundary is 760040. All additional DHll's are assigned addresses modulo 20 
immediately after the first DHll. The DHll gap begins on the 20 boundary 
following the last DHll. 

After all DHll addresses and the DHll gap are defined, DQll, DUll, 
DUPll, LKll, DMCll, DZll, and KMCll addresses and the required gaps 
can be assigned in sequence. Addresses for any future floating address devices 
will be assigned in a similar manner. 



Floating Address Worksheet 

The algorithm for assignment of floating addresses can be confusing for a large 
configuration with multiple units of several types of floating address devices. 
The floating address worksheet that follows is a graphic aid that should elimi- 
nate some confusion and relieve configuration problems. The worksheet allows 
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you to assign device addresses quickly without referring to the formal rules. 
Instructions for use of the worksheet are presented below and two configura- 
tion examples follow. A blank worksheet is also provided for general use. 

The worksheet is divided into four sections covering the address range 760010 
through 762000. Although the floating address area continues up to address 
764000, the worksheet should cover most configurations. If necessary, you can 
create a second worksheet by adding 2000 to all addresses listed. 

The following are the instructions for the use of the worksheet: 

1. Record the quantity of each type of floating address device in the space 
provided on the worksheet. 

2. Beginning at the upper left of the worksheet at address 760010 and pro- 
ceeding down the DJll column, record the unit numbers for all DJll's in 
the configuration. Begin with unit and end with unit n-1. (There are n 
DJll's in the configuration.) 

3. Immediately below the last DJll unit, mark an X for the required DJll 
address gap. Also mark an X in the box immediately to the right (DHll 
column). 

In general, when numbering device units down the appropriate column, 
use only the unshaded boxes. The shaded boxes represent illegal addresses 
for the particular device type. Since the gap address must also be a legal 
device address, use only an unshaded box for the gap X when numbering 
down a column. 

In marking an X in the column to the right of a device aadress gap, use 
shaded boxes since the X in the next column merely provides a starting 
point for numbering units of the next device type. If there are no units of a 
particular device type, enter only the gap X's on the worksheet. 

If you use all available space in one section of the worksheet, simply copy 
the entries on the last line of the full section to the top line of the next 
section. Then continue numbering in the new section. 

4. Continuing just below the X in the DHll column, number all DHll units. 
Once again, start with unit and continue to unit n-1. Skip the shaded 
boxes in numbering down the column. In the first unshaded box below the 
last DHll unit, mark an X for the DHll gap. Also mark an X in the box 
to the right, whether it is shaded or unshaded. 

5. Continue with the remaining floating address devices. In each case, num- 
ber units from to n-1 down the column beginning in the first unshaded 
box below the X. Mark an X in the next unshaded box below the last unit 
and in the box immediately to the right of the last unit (whether that box 
is shaded or unshaded). 

6. After you have recorded all floating address devices, you can read the 
UNIBUS address for each device unit directly from the worksheet. 
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C.2 Floating Vectors 



Many devices have floating vectors. The vector assignment sequence is nor- 
mally the same sequence as that in which the devices enter production. A 
vector for a new hardware option is not inserted before the vector for a device 
that is already in production. Gaps in the vector assignments are not required. 
The floating vectors begin at address 300 and proceed continuously upwards. 
The vector assignment sequence for current devices is defined below. 





First 


Next 


Vector 


Max# 


BR 




Device 


Address 


Addr. 


Size 


Units 


Level 


RSTS/E Notes 


DCU 


174000 


+10 


10 


32 


BR5 




KL11,DL11A,B 


176500 


+10 


10 


16 


BR4 


NON-CONSOLE 


DPll 


174770 


-10 


10 


32 


BR5 


2780 ONLY*** 


DMllA 


175000 


+10 


10 


16 


BR5 


NOT SUPPORTED 


DNll 


175200 


+10 


4 


16 


BR4 


NOT SUPPORTED 


DMllBB 


170500 


+10 


4 


16 


BR4 




DR11A,C 


167770 


-10 


10* 


32 


BR5 


NOT SUPPORTED 


PA611 READER 


172600 


+4 


4* 


16 


BR4 


NOT SUPPORTED 


PA611 PUNCH 


172700 


+4 


4* 


16 


BR4 


NOT SUPPORTED 


DTll (DT03-FP) 


174200 


+2 


10* 


8 


BR7 


NOT SUPPORTED 


DXU 


176200 


+40 


10* 


4 


BR4 


NOT SUPPORTED 


DL11C,D,E 


175610 


+10 


10* 


31 


BR4 




DJll 


FLOAT 


+10 


10* 


16 


BR5 




DHll 


FLOAT 


+20 


10* 


16 


BR5 




GT40 


172000 




20* 




BR4 


NOT SUPPORTED 


LPSll 


170400 


+40 


30* 


14 


BR5,6 


NOT SUPPORTED 


DQll 


FLOAT 


+10 


10* 


16 


BR5 


NOT SUPPORTED 


KWllW 


172400 


NA 


10* 


1 




NOT SUPPORTED 


DUll 


FLOAT 


+10 


10* 


16 


BR5 


2780 ONLY*** 


DUPll 


FLOAT 


+10 


10* 


16 


BR5 


2780 ONLY*** 


DVU 


175000 


+40 


20* 


4 


BR5,6 


NOT SUPPORTED 


LKll 


FLOAT 


+10 


10* 


1 


BR4 


NOT SUPPORTED 


DMCU 


FLOAT 


+10 


10* 


16 


BR5 


DECNET/E ONLY* 


DZll 


FLOAT 


+10 


10* 


8 


BR5 




KMCll 


FLOAT 


+10 


10* 


16 


BR5 




TS04 


172524 


+4 


4 


4 


BR5 


Second, third, and 
fourth units 



*The first vector for the first device of this type must always be on a 10(8) boundary. 
**DECnet/E limits the maximum number of units to sixteen. 
***Also supported at BR6 under RSTS/2780. 
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C.3 Fixed Address and Vectors 

The following table lists the devices supported under RSTS/E that have fixed 
addresses and vectors. 



Device 


Address 


Vector 


BR Level 


RSTS/E Notes 


RFll 




277460 


204 


BR5 


UP TO 8 PLATTERS 


RS03/RS04 




172040 


204 


BR5 


UP TO 8 DRIVES 


RK05/RK05F 




177400 


220 


BR5 


UP TO 8 DRIVES* 


RL01/RL02 




174400 


160 


BR5 


UP TO 4 DRIVES 


RK06/RK07 




177440 


210 


BR5 


UP TO 8 DRIVES 


RP02/RP03 




176710 


254 


BR5 


UP TO 8 DRIVES 


RM02/RM03 




176300 


150 


BR5 


UP TO 8 DRIVES 


RP04/RP05/RP06 


176700 


254 


BR5 


UP TO 8 DRIVES 


RX01/RX02 




177170 


264 


BR5 


UP TO 8 DRIVES 


DECtape 




177340 


214 


BR6 


UP TO 8 DRIVES 


TU10/TE10/TS03/TS04 


172520 


224 


BR5 


UP TO 8 DRIVES 


TS04 




172520 


224 


BR5 


UP TO 8 DRIVES 


TU16/TE 16ArU45/TU77 


172440 


224 


BR5 


First drive only 


LPll.LSll 


(LPO) 


177514 


200 


BR4 


UP TO 8 DRIVES 




(LPl) 


164004 


170 


BR4 


UP TO 8 DRIVES 




(LP2) 


164014 


174 


BR4 


DEPENDING ON 




(LP3) 


164024 


270 


BR4 


SPEED. 




(LP4) 


164034 


274 


BR4 






(LP5) 


164044 


774 


BR4 






(LP6) 


164054 


770 


BR4 






(LP7) 


164064 


764 


BR4 




CRll.CMll 




177160 


230 


BR5 




CDll 




177160 


230 


BR4 




KWllL 




177546 


100 


BR6 




KWllP 




172540 


104 


BR6 




KGll 




170700 


NONE 


NONE 




KL11,DL11A,DL11B 


177560 


60 


BR4 


2780 ONLY 












CONSOLE INTERFACE 



*Each RK05F must be counted as two drives. 



C.4 RH70 BAE and CSS Addresses 



The following table lists the four possible RH70 High Speed I/O Controller 
addresses, their Bus Address Extension (BAE) and Control addresses, their 
Bus Address Extension (BAE) and Control Status 3 (CS3) addresses, and 
their usages. 



Usage 



Address 



BAE 



CS3 



RS03/RS04 only 


172040 


172070 


172072 


TU16/TE16/TU45/TU77 only 


172440 


172474 


172476 


mixed/nonstandard 


176300 


176350 


176352 


RP04/RP05/RP06 or 


176700 


176750 


176752 


RM02/RM03 
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Appendix D 

RSTS/E System Library Controi Fiies 



There are five system library control files on the RSTS/E distribution kit and 
Table D-1 summarizes the function of each. Because all RSTS/E systems 
require the standard system library, you must run the BUILD program using 
the BUILD. CTL file. Build the other libraries only if you plan to include their 
optional features on your system. 

Table D-1: Control Files for the BUILD Program 



File 


Function 


BUILD.CTL 


Builds and patches the standard system library required for all systems. 


SPLER.CTL 


Builds the Spooling Package system library files. 


BIGPRG.CTL 


Builds files for certain large programs. 


BACKUP.CTL 


Builds files for the BACKUP Package library. 


DEVTST.CTL 


Builds the Device Testing Package. 



D.1 BUILD.CTL File 



Commands in the BUILD.CTL file create a standard system library for all 
systems. Table D-2 lists and describes the programs and files contained in the 
standard library. Also, included in Table D-2 are manual references which 
you can use to find more detailed descriptions of each program and file. The 
references that Table D-2 provides point to sections in this manual, to the 
RSTS/E System User's Guide (SUG), the RSTS/E System Manager's Guide 
(SMG), or the RSTS/E Text Editor Manual (TEM). 
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Table D-2: BUILD.CTL Programs and Files 



Program or 
File Name 


Protection 


Description 


Manual 
Reference 


CPATCH.BAC 


<124> 


Creates system library patching 
command files. 


SMG 


AUTOED.BAC 


<124> 


Editor for system library patching. 


SMG 


ATPK.BAC 


<232> 


Processes command files. 


SMG 


LOGIN.BAC 


<232> 


Logs users into system. 


SUG 


LOGOUT.BAC 


<232> 


Logs users off system. 


SUG 


PATCPY.BAC 


<124> 


Copies patch files. 


SMG 


PBUILD.BAC 


<124> 


Builds system library patching files. 


SMG 


UTILTY.BAC 


<124> 


Performs system utility routines. 


SMG 


INIT.BAC 


<124> 


Initializes system at start of time 
sharing. 


SMG 


SHUTUP.BAC 


<124> 


Performs system shut down. 


SMG 


ERRBLD.BAC 


<124> 


Builds error data file for use by 
ERRDIS package. 


SMG 


ERRINT.BAC 


<124> 


Validates or initializes 
ERRLOG.FIL. 


SMG 


ERRCPY.BAC 


<124> 


Copies hardware error data to a disk 
file. 


SMG 


DIRECT.BAC 


<232> 


Lists device directories. 


SUG 


TTYSET.BAC 


<232> 


Sets terminal characteristics. 


SMG 
SUG 


SYSTAT.BAC 


<232> 


Reports system status. 


SMG 
SUG 


EDIT package 


<104> 


Text editor. 


TEM 


BUILD.BAC 


<124> 


Builds and patches system library 
files. 


Chapter 6, 
Section 7.4 


ERRDIS package 


<124> 


Formats error data. 


SMG 


ANALYS Package 


<124> 


Analyzes system crash information 
and retrieves error data. 


SMG 


ODT.BAC 


<124> 


Octal debugging tool. 


SMG 


REACT.BAC 


<124> 


Creates user accounts. 


SMG 


REORDR.BAC 


<124> 


Restructures user file directories for 
optimal performance. 


SMG 


DSKINT.BAC 


<124> 


Initializes formatted disks. 


SMG 


UMOUNT.BAC 


<232> 


Mounts and dismounts private disks. 


SUG 


COPY.BAC 


<104> 


Copies entire tapes and disk 
cartridges. 


SUG 



(continued on next page) 
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Table D-2: BUILD.CTL Programs and Files (Cont.) 



Program or 
File Name 


Protection 


Description 


Manual 
Reference 


FILCOM.BAC 


<104> 


Compares ASCII files. 


SUG 


QUOLST.BAC 


<232> 


Lists disk quota and usage data for 
current user. 


SUG 


MONEY.BAC 


<104> 


Performs system accounting 
functions. 


SMG 
SUG 


GRIPE.BAC 


<232> 


Records user comments. 


SMG 
SUG 


TALK.BAC 


<232> 


Provides inter-terminal 
communications. 


SMG 


PLEASE.BAC 


<232> 


Prints requests at terminal and 
interacts with OPSER package. 


SMG 


INUSE.BAC 


<104> 


Prints terminal "INUSE" warning 
message. 


SUG 


SWITCH.BAC 


<232> 


Changes the private default run-time 
system. 


SUG 


ONLCLN.SAV 


<124> 


Cleans disks during time sharing. 


SMG 


NOTICE.TXT 


<40> 


Sample system notices text file. 


SUG 


HELP.HLP 


<40> 


Sample system help message text 
file. 


SUG 


RTS.CMD 


<60> 


Sample indirect command file for 
adding auxiliary run-time systems. 


SMG 


'll'Y.CMD 


<60> 


Sample indirect command file for 
setting terminal characteristics. 


SMG 


CCL.CMD 


<60> 


Sample indirect command file for 
defining CCL commands. 


SMG 


START.CTL 


<60> 


Sample system start-up control file. 


SMG 


CRASH.CTL 


<60> 


Sample system crash recovery 
control file. 


SMG 


ANALYS.CMD 


<60> 


Sample indirect command file for 
crash analysis. 


SMG 


CLEAN.CMD 


<60> 


Sample indirect command file for 
cleaning disks. 


SUG 


UTILTY.HLP 


<40> 


UTILTY program help message file. 


SMG 


DIRECT.HLP 


<40> 


DIRECT program help message file. 


SUG 


ERRDIS.HLP 


<60> 


Error display program help file. 


SMG 


ACCT.SYS 


<188> 


Sample system accounts file. 


SMG 


COPY.HLP 


<40> 


COPY program help message file. 


SUG 
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D.2 SPLER.CTL File 



Commands in the SPLER.CTL file create programs and files for the Spooling 
Package. Table D-3 contains the name, the protection code, and a brief 
description of each of these programs and files. Use the manual references, 
also contained in Table D-3, to find a more detailed explanation of each 
component in the Spooling Package. The references direct you to either the 
RSTS/E System User's Guide (SUG) or the RSTS/E System Manager's 
Guide (SMG). 



Table D-3: SPLER.CTL Programs and Files 



Program or 
File Name 


Protection 


Description 


Manual 
Reference 


OPSER package 


<124> 


Operator services package. 


SMG 


CHARS.BAC 


<124> 


Creates the character generation file, 
CHARS.QUE. 


SMG 


QUE. BAG 


<232> 


Creates requests for spooling 
programs. 


SUG 


QUE Management 
Package 


<124> 


Queue management package. 


SMG 


SPOOL.CMD 


<60> 


Sample command file for starting up 
spooling programs. 


SMG 


BATDCD.BAC 


<124> 


Creates BATCH program command 
decoding file BATCH.DCD. 


SMG 


SPOOL package 


<124> 


Line printer spooling package. 


SMG 


BATCH package 


<124> 


Batch control spooling package. 


SMG 
SUG 



D.3 BIGPRG.CTL File 



Commands in the BIGPRG.CTL file create programs that are used with 
certain peripheral devices and optional software. Table D-4 contains the 
name, the protection code, and a brief description of each program in the 
BIGPRG command file. In addition. Table D-4 contains a manual reference 
that you can use to find a more detailed description of each program. The 
references direct you to the RSTS/E System User's Guide (SUG), the RSTS/E 
Programmer's Utilities Manual (PUM), or the RSTS/E System Manager's 
Guide (SMG). 
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Table D-4: BIGPRG.CTL Programs and Files 



Program or 
File Name 


Protection 


Description 


Manual 
Reference 


VT5DPY.BAC 


<232> 


Displays system status on VT05. 
Created from DISPLY.BAS and 
VT05.DPY. 


SMG 


VT50PY.BAC 


<232> 


Status display program for VT50 and 
VT52. Created from DISPLY and 
VT50.DPY. Also used on VTIOO. 


SMG 


FIT.BAC 


<232> 


Transfers files to and from diskettes, 
DECtape lis, and RTll formatted 
disks. 


SUG 


FLINT.BAC 


<104> 


Copies files between IBM-compatible 
diskettes and RSTS/E disks. 


SUG 


PMDUMP.BAC 


<104> 


Provides post-mortem dump of low 
memory and user job area. 


SUG 


BPCREF Package 


<104> 


Creates cross-reference listing for 
BASIC-PLUS programs. 


SUG 


RUNOFF.BAC 


<104> 


Formats typed or printed 
manuscripts. 




MAKSIL.BAC 


<124> 


Generates a Save Image Library 
from a Task Image File. 


PUM 


SAVRES.SAV 


<124> 


SAVES, RESTORES, and IMAGE 
copies entire disk packs. 


SMG 



D.4 BACKUP.CTL File 



Commands in the BACKUP.CTL file create programs for the BACKUP 
Package. Table D-5 describes the contents of this package and provides the 
names of the RSTS/E documentation manuals which can help you locate a 
more detailed description of the BACKUP Package. The references direct you 
to either the RSTS/E System Manager's Guide (SMG) or the RSTS/E System 
User's Guide (SUG). 

Table D-5: BACKUP.CTL Programs and Files 



Program or 






Manual 


File Name 


Protection 


Description 


Reference 


BACKUP package 


<232> 


Transfers information from disk to 


SMG 






tape or disk and restores the infor- 


SUG 






mation to the original volume. The 








package contains 15 programs, two 








of which do not have a protection 








code of <232>. BACENT.BAC and 








BACPRM.BAC have protecton codes 








of <124>. 




BACDSK.BAC 


<232> 


Writes BACKUP file structure on 


SMG 






disks. 
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D.5 DEVTST.CTL File 



Commands in the DEVTST.CTL file create executable programs for the 
Device Testing Package. Table D-6 contains a description of each program in 
this package. For a complete explanation of the DEVTST package, refer to 
the RSTS/E System Manager's Guide (SMG). 

Table D-6: DEVTST.CTL Programs 



Program or 
File Name 


Protection 


Description 


DSKSEK.BAC 


<124> 


Tests the normal operation of non-file structured disk 
controllers. 


DSKEXR.BAC 


<124> 


Tests the normal operation of all file structured disks. 


LPEXER.BAC 


<124> 


Test prints a rotating pattern of ASCII characters 
and specified number of pages and is used to test any 
line printer. 


PPEXER.BAC 


<124> 


Tests the normal operation of the paper tape punch 
by punching random patterns on the paper tape for 
input into the PREXER. 


PREXER.BAC 


<124> 


Tests the normal operation of the paper tape reader. 


DXEXER.BAC 


<124> 


Tests the normal operation of the diskette controller. 


DTEXER.BAC 


<124> 


Tests the normal operation of the DECtape controller 
and drives. 


CPEXER.BAC 


<124> 


Tests the CPU to verify that it is performing properly. 


CPUTST.BAC 


<124> 


Tests the integrity of CPU addresses. 


KBEXER.BAC 


<124> 


Tests terminals. 


MTEXER.BAC 


<124> 


Checks the normal operation of magnetic tape con- 
trollers and drives. 
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Appendix E 

System Generation Exampies 



The two sample RSTS/E system generations that follow are provided here to 
give you an overall view of the entire generation process and ultimately to 
help you generate your RSTS/E system. Since the size of your system effects 
some of the decisions you must make during the generation process, two 
system generations are provided, one created for a small and the other for a 
large system configuration. For those that have, for example, two RKOS's, one 
RP04, and approximately 128K words of memory, follow the sample genera- 
tion of the small system which begins on page 2. Those installations that have 
more peripherals and larger memory (450K words) can follow the large system 
sample generation beginning on page 67. It must be stressed that these exam- 
ples should only be used as rough guidelines. Generating your system exactly 
like one of the samples may cause your system to run less efficiently than it 
might otherwise. Therefore, determine the size and needs of your system and 
generate it accordingly. 

The instructions that the SYSGEN program provides for each of the questions 
in the system generation process are included in the samples for your conven- 
ience. These instructions can be invoked by simply pressing RETURN in 
response to any of the questions. Also, you have the option before you answer 
the configuration questions (page E-13 and page E-77) to select the short or 
long form of the question. The long form option was selected for both genera- 
tions and when selected may help you choose the proper response. If you 
choose the short form, the long form explanations can be invoked by pressing 
RETURN. 

As a final note, it is suggested that you study these examples before you 
generate your system. They may help you to avoid problems which can cost 
you time and effort. 
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System Generation Example — Small System Configuration 

Enablinfi^ oril'.:{ con<i>o:i,ey d:i.sksy and taFstii ♦ 
RSTS V7»0 (DKO) 



Oration* 

Please enter one of the va!!. :i.ci RJ3TS/E <r>wi5teiri :ln:lt:l<"f:i:L:;c;3t:Lan 

options* or twpe 'HELP' for b heJ.}" inessai^eJ HELP 

The V 3.1 id RBTS initialization options ara^t 

DSKINT Initialize disk to RSIB filo^ structure 

COPY Copw lYiiniitial system to disk 

PATCH Patch a file 

HARHWR Bet cont r o 1 1 e r cfia r acte r i <;>t i cs 

INSTALL Install a monitor Sl'L 

REFRESH Manipulate files in i::0 !-:!.:] 

DEFAULT Set monitor defaults 

S E T S e t d © V i c^ e ' c h a r a c t e r i s t i c s 

START Start timesharin<-i 

< L F ::=• S t a r t t i in e s h <:t r i 1 1 v-i ( f a s t ) 

BOOT Bootstrap a device 

LOAD Load a stand-alone pro;-{ram 

UNISYS Disable all but console terminal 

FILL Set console fill for INIT 

SAVRES SAVE or RESTORE a RSTS/E disk 

HELP Twpe this HELP messa^^e 
Onl»:« the first two characters need be twped* 



Option: DSKINT 

22-Apr--79? 

Enter date as 'DAY-MONTH-YEAR' <e,<}i.y 31 -DEC -76) 

or as 'YEAR»MONTH»DAY' (e.j-U. 76,12*:51) ? 22-APR-79 

12t04 AM? 

Enter time as 'HOUR JMINUTES AM' or 'HOURtMXNUTES P.M ' <e.;=i* HI'S PM: 

or in 24-hour format as 'HOUR J MINUTES' Ui.<:U 13 J 15) ? 4M8PM 

Disk? 

D i sk type ( DC r DF ? DS t DK y DL » DM i- DP ? DB 9 DR ) ? DB 

Unit? 

Physical unit number (0-7)? 

This disk pack appears to be a RSTS/E formatted 
disk with the followin^J characteristics! 

Pack ID : SAMPL2 

Pack Cluster Size * 4 

Pack is currently J Private y 

Update access date on writes* 

Pack ID? 

Up to 6 alphanumeric characters? SMLV70 

P a c k c 1 "..( s t e r s i z e ? 

At Bt or 16? 8 

SATT»SYS base? 

Type a block number to locate the file SATT*SYS at a specific 

place on the disky or type <LF> to let RSTS find a location « 

SATT»SYS base? 20000 

MFD password? 

Uf to ' 6 alphanumeric characters? WHERE 
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MFD cluster size? 

8 or :l,6? e 

P r e ~ e x t e n d d :i. t' e» t;y t o y" :i. e s < no > ? 

Type YES to force the MFD arnJi accounts COyi:] and i:i. y2:] 

be p re-extended to their maKimuiri size when created* 

P r e •••• e ;■« t e n d d :i. r e c t o r i e s < ci o > ? YES 

PUBi- PRXp or SYS? 

Public <PUB>y private (PRl>y or s^:istem (SYS) disk? BYS 

L i b r a »' w p a ii> lii w <:) r d ? 

Up to a alphanumeric characters? WHATME 

Library UFD cluster size? 

3 or 16? 16 

Lib rarw account base? 

Type a block number to locate the library account at a specific 

Place on the diskc or twpe <I...F> to let KSTS find a location* 

Librarvj account base? 20000 

Date last modified <wes>? 

Type 'YES' to maintain date of last modification in the 

directory on this disk* 

Type 'NO'' to maintain the date of last access* 

Should this disk retain last -modified information? YES 

New files first <no>? 

Type 'YES' to force new directory entries to be 

added to the front of the directory* 

Type 'NO' to force new entries to be added to 

the end* 

Should directory entries be added to the front? NO 

Use previous bad block info <yes>? 

If the disk you are initializing^ is already a RSTS 

file-structured disk? there is a file which tells where 

bad pack clusters &re on the disk* Type 'YES' to use 

this information in creatinsi the new bad block file for 

this disk? type 'NO' to i«i^nore the previous bad block 

file* Use previous bad block info <yes>? YES 

Format <no>? 

Should the pack be formatted (Y or N)? NO 

Patterns? 

Number of patterns to use in check in.*^ for bad blocks (O-S)* 

Time r e « u i r e d p e r p a 1 1 e r n < m i n u t e s ) ♦ 

DF«=*25/platter!' BK''-1 y DM='=2*5» DP X DB=^10* 

How many patterns should be used in check insJ the disk? S 

Proceed (Y or N)? 

Type 'Y' to proceed with DSKINTi- 'N' to abort it? YES 

Pattern # 8 

OBO Error RPCSl RPWC RPDA RPCS2 RPDS RPERl RPDC 

144250 171152 010000 040300 150700 100000 000602 
144250 171152 010000 040300 150700 lOOOOO 000602 



Recoverable 



Block Cluster 
162108 20263 



Recoverable 
Pattern # 7 



144250 177553 010000 040300 150700 100000 000603 
144250 177553 010000 040300 150700 100000 000603 
144250 177553 010000 040300 150700 100000 000603 



144250 176553 010000 040300 150700 100000 000604 
144250 176553 010000 040300 150700 100000 000604 



DBO Error RPCSl RPWC RPDA RPCS2 RPDS RPERl RPDC 

144250 174326 003005 040300 150700 100000 000601 



Recoverable 



144250 177553 010000 040300 150700 100000 000603 
M4250 177553 010000 040300 150700 100000 000603 
144250 177553 010000 040300 150700 100000 000603 
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Block Cluster 
162108 20263 



162526 203 IS 
Pattern * 6 
DBO Error 

Recoverable 



Block Cluster 
162526 20315 



144250 
144250 
144250 
144250 



176553 
176553 
177553 
177553 



010000 040300 150700 100000 000604 

010000 040300 150700 100000 000604 

010000 040300 150700 100000 000604 

010000 040300 150700 100000 000604 



RPCei RPWC 

144250 177553 

144250 177553 

144250 176553 

144250 176553 

144250 177553 

144250 177553 



RPDA 


RPCB2 


RPi:i8 


RPERl 


RPDC 


010000 


040300 


150700 


100000 


000603 


010000 


040300 


150700 


100000 


000603 


010000 


040300 


150700 


100000 


000604 


010000 


040300 


150700 


100000 


000604 


010000 


040300 


150700 


100000 


000604 


010000 


040300 


150700 


100000 


000604 



Pattern * 5 
















DBO Error 


RPCSl 


RPWC 


RPDA 


RPCB2 


RPD8 


rpi:;:ri 


RPDC 




144250 


177553 


010000 


040300 


150700 


100000 


000603 




144250 


177553 


010000 


040300 


150700 


100000 


000603 




144250 


177553 


010000 


040300 


150700 


100000 


000603 




144250 


177553 


010000 


040300 


150700 


100000 


000603 


Block Cluster 
















162108 20263 


















144250 


176553 


010000 


040300 


150700 


100000 


000604 




144250 


176553 


010000 


040300 


150700 


100000 


000604 




144250 


177553 


010000 


040300 


150700 


100000 


000604 




144250 


177553 


010000 


040300 


150700 


100000 


000604 



162S26 20315 
Pattern * 4 
DBlD Error 



Block Cluster 
162108 20263 



162526 20315 
Pattern ♦ 3 
DBO Error 



Block Cluster 
162108 20263 



RPCSl 


RPWC 


RPDA 


RPCS2 


RPDS 


RPERl 


I-;;PDC 


144250 


177553 


010000 


040300 


150700 


100000 


000603 


144250 


177553 


010000 


040300 


150700 


100000 


000603 


144250 


177553 


010000 


040300 


150700 


100000 


000603 


144250 


177553 


010000 


040300 


150700 


100000 


000603 


144250 


176553 


010000 


040300 


150700 


100000 


000604 


144250 


176553 


010000 


040300 


150700 


100000 


000604 


144250 


177553 


010000 


040300 


150700 


100000 


000604 


144250 


177553 


010000 


040300 


150700 


100000 


000604 



RPCSl 


RPWC 


RPDA 


RPC82 


RPDS 


RPERl 


RI"'DC 


144250 


177553 


010000 


040300 


150700 


100000 


000603 


144250 


177553 


010000 


040300 


150700 


100000 


000603 


144250 


177553 


010000 


040300 


150700 


100000 


000603 



Pattern * 2 












DBO Error 


RPCSl 


RPWC 


RPDA 


RPCS2 


RPDS 




144250 


174325 


003005 


040300 


150700 




144250 


174325 


003005 


040300 


150700 




144250 


177726 


003005 


040300 


150700 



RPERl RPDC 

100100 000601 

100100 000601 

100000 000601 
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Block Cluster 



161066 



1621 OB 



162526 



;oi3: 



>0263 



203 :H 



144250 


177553 


144250 


177553 


144250 


177553 


144250 


177553 


144250 


176553 


144250 


176553 


144250 


177553 


144250 


177553 



010000 040300 150700 100000 000603 

010000 040300 150700 100000 000603 

010000 040300 150700 100000 000603 

010000 040300 150700 100000 000603 

010000 040300 150700 100000 000604 

010000 040300 150700 100000 000604 

010000 040300 150700 100000 000604 

010000 040300 150700 100000 000604 



Pattern * 1 



DBO Error 


RPCSl 


RPWC 


RPDA 


RPCB2 


RPDS 




144250 


177553 


010000 


040300 


150700 




144250 


177553 


010000 


040300 


150700 




144250 


177553 


010000 


040300 


150700 


Block Cluster 












162100 20263 













|:;:PER1 RPDC 

100000 000603 

100000 000603 

100000 000603 



Option: COPY 

22~Apr-79? 

Enter date as 'DAY-MONTH-YEAR' (e ♦<=!♦> 31-I.1EC-76) 

o r as ' YEAR ♦ MONTH ♦ .DAY ' ( e ♦ ?•{ ♦ y 16 ♦ 1 2 » 3 1 ) ? 22- APR'-79 

06 J 06 PM? 

Enter time as 'HOUR J MINUTES AM' or 'HOUR? MINUTES PM' <e*<v5« 1515 PM> 

or in 24 -hour forinat as 'HOUR J MINUTES' (e*?-?* 13 J 15) ? 6 J 06 PM 

To which disk? 

Type the name of the disk which is to receive the RSTS/E system* 

The disk must alread^j be initialized* 

Valid disk names are DFv DSs* DKy DLy DMy DPy DBy and DR. 

To which disk? DB 

Unit? 

Physical unit number <0-7)? 

Enablin?^ onlw console y disks y <iu(A tapes* 



RSTS V7«0 (DBO) 
Option: HARDWR 

H A R ][! W R !"> u b o p t i <:) fr ? 

V a 1 i d H A R D W \< s u b o p t i o n «► BveX 



LIST List hardware conf is-Juration 

DISABLE Disah:>le a controller 

ENABLE Enable a disabled controller 

CSR Enter non-standard controller address 

VECTOR Enter non-standard vector address 

UNITS Associate a disk type with a controll 

DM Set DMllBB/DHll associations 

TU5S Set TU58/DL11 associations 

HERTZ Set AC line hert.;: 

SWITCH Set console switch re<^ister character 

RESET Reset all user CSR's X vectors y enabl 

EXIT (or <LF>) Exit from HARDWR option 



i sties 

e all devices 



Only the first two characters need be typed 
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HARDWF;: suboptlon? LIST 



Name 


Address 


Vector 


Coiiiinents 


tt: 


177560 


060 




rk: 


177400 


220 


RK05F unitiiiJ none 


rb: 


176700 


254 


Units: 0(RP04) 


DEO I 


175610 


300 


Unltiij: 


DEI J 


175620 


310 


Units: 


mo: 


160050 


320 




xMo: 


160100 


330 




XMlt 


160110 


340 




XM2J 


160120 


350 




XM3J 


160130 


360 




DZOt 


160150 


370 




TfZlt 


160160 


400 




XKO J 


160200 


410 





KWllL 177546 100 
SR 177570 
DR 177570 

Hertz == 60* 

HARDWR suboptlon? EXIT 
Option: INSTALL 
Sil? 

Tw^e the filename of the monitor save imaivie library* 
Directory of all tSIL files in llOfi'Jit 

sysgen»s:i:l 

Sil? SYSGEN 

Rebootin;^ ♦ ♦ ♦ 



RSTS V7.0 (DBO) 



Option: REFRESH 

22" Apr -79? 

Enter date as 'DAY-MONTH-YEAR' (e*i3»y 31-DEC--76) 

or as 'YEAR.MONTH»DAY' (e»s!w 76,12«31) ? 22-APR-79 

06: 08 PM? 

Enter time as 'H0UR:MINUTES AM' or 'H0UR:MINUTES PM' ie*iS* IIX'5 PM) 

or in 24-hour format as 'H0UR:MINUTES' <e*<-J» 13:i5) ? 6:08 PM 

Disk? 

Type the name of the d i sk to r ef resh ( DC t DP r DS 9 DK v DM » DP f or DB ) ♦ 

Type <LF> to refresh the system disk* 

Disk? DB 

Unit? 

Physical unit number (0-7)? 

Clean? 

Type 'YES' if you want the disk cleaned before REPRESHins!* 

Type 'NO' to skip the clean operation* 

Clean? YES 

D i s k i s b e i I'l <:-i c 1 e *:M"i e d - wait ♦ ♦ ♦ 
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REFRIE:SH <i>ubar-tion? 

Valid REFRESH suboptions are* 

LIST List the file status table 

CHANGE ChaiL^e the system file allocation 

FILE Chansie the characteristics of a file in r.OtiJi 

BADS Examine or change the bad block file 

EXIT (or <LF>> to exit from REFRESH 

Onlw the first two characters ne&d be twped 



REFRESH suboption? LIST 

File File Current Minimum 

Name Required? Fla;j{s Status Size Size 



Start 
LBN 



System filesJ 



SWAP 


♦ SYS 


YES 






SWAF^O 


♦ SYS 


NO 






SWAF'l 


♦ SYS 


NO 






SWAP3 


♦ SYS 


NO 






OVR 


♦ SYS 


NO 






ERR 


♦ SYS 


NO 






BUFF 


♦ SYS 


NO 






CRASH 


♦ SYS 


NO 






Others: 










BADB 


♦ SYS 






NOD 


SATT 


♦ SYS 




NOD 


CTG 


INIT 


♦ SYS 




NOD 


CTO 


ERR 


♦ ERR 






CTG 


SYSGEN»SXL 




NOD 


CTG 


RTll 


♦ RTS 






CTG 



CRE 
OK 
OK 
OK 
OK 
OK 
OK 
OK 



32 
6 

4:1.8 

16 

204 

20 



64 



57 
16 

24 



20004 
604 
828 



REFRESH suboption? CHANGE 

SWAP ♦SYS changes? 

SWAP ♦SYS is required on the system disk to brin<iJ up timesharinj-J^ 

It must be bi:^ enousfh to hold at least two Jobs at the system swap 

maiu When the system is broufiJht upy SWAP ♦SYS will be in the third 

swap file position ♦ 

Type 'NO'i' 'OLD'i' or <LF> for no chan<.1e in status ♦ 

Type 'YES' to enter file data^ 

SWAP ♦SYS chansJes? YES 

Si:Ke? 

Type 'OLD' or <LF> to default to the minimum size of 64 blocks* 

Otherwise K enter the file size in 256 word blocks^ 

Size? 10*2eK 

Base? 

Type 'OLD'r '0'» or <LF> to let RSTS find a location* 

Enter a loi^ical block number to locate the file at a specific 

place on the disk* 

Base? 20000 

SWAPO^SYS changes? 

This file may be used as an additional swappin;;! file if it is 

installed as such during system start -up* 

Type 'NO')- 'OLD'» or <LF> for no change in status* 

Type 'YES' to enter file data^ 



System Generation Examples E-7 



SWAPO»BYS chan<.-{eij>? YES 

Size? 

Enter* the file size in 2 '3 6 word b.lo<:^k5» 

Size? :|.5!K2SK 

Base? 

Twpe 'OLD'y 'O'y or <LF> to let RSTS find a location* 

Enter a loidical block number to locate the file at a sr-'ecific 

Place on the disk* 

Base? 20000 

SWAP! ♦ SYS chansJes? 

This file mBH be used as an additional swappin'S file if it is 

installed as such durin?^ s^i/stem start -up* 

T w p e 'HO' r ' 1.. D ' > o r < I... I-" > f o r' n o c h a i-i <^ e i n s t <•► t u s ♦ 

Type 'YES' to enter file data* 

SWAP;L*SYS chan.«(es? NO 

SWAP:J*SYS chan««es? 

This file mi-iu be used as an additional swappin<.^ file if it is 

installed as such durin;;^ svsfstein start -up* 

Type ' N ' y ' 1... B ' > o r ■=:.' I.„ I"' > f o r rr o c h a \"i ;=! e i n s t a t u s * 

Type 'YES' to enter file data* 

SWAP3*SYS ch an J3es? NO 

OVR*SYS chan<3es? 

OVR*SYS may be used to hold the non-resident system code if it is 

installed as such durin.«^ system start-up* 

Type 'HO' y ' L. B ' y or < L F > f o r n o c h a n j.s e i n s t a t r..i ii> * 

Type ' Y E S ' t o e n t e r* f i 1 e d a t <i> ♦ 

OMR*SYS changes? NO 

E R R ♦ S Y S c h <•) n ?iJ e <r> ? 

ERR*SYS may be used to hold the system error messai^e text if it is 

installed as such during system start -up* 

Type ' N ' y ' L B ' y or < I,. I- > f o r no c Ji a ri ^A e i n s t a t u s * 

Type 'YES' to enter file data* 

ERR* SYS chan.««es? NO 

BUFF* SYS chan<-?es? 

BUFF* SYS is used for BECt ape operations* 

It must contain at least 3 blocks vbv supported BECt ape* 

BUFF*SYS is required on the system disk if BECtape is to be used* 

Type 'NO'y 'OLB'y or <LF> for no chans-ie in status* 

Tvjpe 'YES' to enter file data* 

BUFF* SYS chanjijes? NO 

CRASH * SYS chanj'ies? 

CRASH* SYS is used to hold a dump of the monitor's tablets 

if the system crashes and the crash dump option is enabled* 

Type 'NO'y 'OLB'y or <LF> for no chan;^e in status* 

Type ' Y E S ' \. o e ri t o:? r f i 1 (s d a t a * 

CRASH* SYS chan;..Jes? YES 

Size? 

Type 'OLB' or <LF> to default to the minimum size of 24 blocks* 

Otherwisey enter the file size in 256 word blocks* 
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Size? BO 

Type 'OLD' » 'O'y or <I..,F> to .Let RST9 f:i.nd b locirlion* 

Enter a loj^ical block number to locate the file at a specific 

place on the disk* 

Base? 

Other files? 

Twpe the NAME ♦EXT of a file to be created or deleted durinrf 

this CHANGE operation* Twpe <LF> if there Bve no more files* 

Other files? 

REFRE^BH suboption? EXIT 
Option? DEFAULT 

No defaults are currently set in SYSGEN»S1I... 
You currently have: JOB MAX ==== 2» SWAP MAX :"= 16K* 
JOB MAX or SWAP MAX chansJes? 
JOB MAX or SWAP MAX maw be chan<i{ed as follows? 

1) JOB MAX maw never be <^r eater than 2v which is the Job maximum 
specified at swstem <-{eneration time* 

2) SWAP MAX? which is expressed in K of memorw <1K""1024 words)? maw 
never be <dreater than 3:1 <K) or less than 8 <K)* 

3) Each of the four possible swap files am hold N Jobs* where 

N •■--' ZSize of swap file (in blocks )::i / LSWAP MAX (K) * Al 
truncated to an inte<=ier* The sum of the N's for the four swap 
files determines the number of Jobs which maw lo<.^ on* This number 
maw be increased on line bw add in<^ swap files <up to a maximum of 
Af in c I u d i n si S W A 1=' * S Y S ) ? b u t iri a w i"i e v e y' e >i c e e d t he JOB MAX s p e c i f i e d 
at start -UP time* 

4) The one required file? SWAP* SYS y must be at least INSWAP MAX * B3 
blocks loniSy so that it can hold two Jobs* 

Twpe 'YES' to chan'^e JOB MAX or SWAP MAX* Twpe 'NO' to leave the 
maxima as thew stand* Anw chan<-les? YES 

New JOB MAX? 

Twpe 'NO' if wou don't want to chan<-Je the current JOB MAX* 
To enter a new JOB MAX? twpe a number between 1 and 2* 

New JOB MAX? 2 

New SWAP MAX? 

Twpe 'NO' if wou don't want to chan;-$e the current SWAP MAX* 
To enter a new SWAP MAX/ twpe a number between 8 and 31 (K>* 

New SWAP MAX? 28 

You cur rent Iw have? JOB MAX === 2y SWAP MAX === 2BK* 

JOB MAX or SWAP MAX chansies? NO 
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R u n T i m e S w s t e in ? 

SF-ejcifw the name of the Run Time JBwstem to be used as the swstem 
default* The named Run Time System must exist on the swstem disk 
in account llOnliJ with extension '♦RTB'* 

Directorw of all valid run time swstemsJ 

RT11»RTS 

Name of default Run Time System? RT1.1. 

Error messasJe file? 

Sr-ecify the name of a file in irOri:] with extension '♦ERR' 
which contains the RSTS/E error messai^e text* 

Directory of valid error messa;={e files* 

ERR ♦ ERR 

Name of error messasie file? err 

I n Si t a 1 1 iij t i o n ri <:Mri e ? 

Enter the installation name as a strin«f of up to VJi characters* 

New installation name? RSTS/E SYSGEN 

Memory a 1 1 o c a t i o n t a b 1 e J 



ok: 00000000 - 00127777 c 22K) 

22k: ooi;?oooo ■•" 00147777 ( 410 

26ki ooisoooo - 00757777 ( 9810 

124K: 00760000 - End 



EXEC 

RTS (RTll) 

USER 

NXM 



T a b 1 e s u b o p t i o n ? 

Valid table suboptions are* 

LIST List the current memory allocation table 

PARITY List the parity memory conf ii^uration 

RESET Let RSTS reset the default memory conf ii^uration 

LOCK Lock out some memory 

UNLOCK Unlock some locked memory 

RTS Move the Run Time System to a special location 

MAP Specify a portion of XHUF to be mapped with UMR's 

XBUE Allocate extended buffer space for disk/messa.<-le cachin<S 

EXIT (or <LF>) when you are satisfied with the table 

Only the first two characters need be typed 

Table suboption? £XIT 

You currently have crash dump disabled* 

Crash dump? 

Type 'YES' to enable crash dump at startup time* 
Type 'NO' to disable crash dump* 

Enable crash dump? YES 

M a «i t £> p e 1 a b e 1 1 i n <i d e f a u 1 1 < n o n e > ? 

Type 'ANSI' to select ANSI standard ma<.^tape label linid for system default 
Type 'DOS' to select DOS format ma<^tape labelliniiS for system default* 
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naatape label Uru^ default <nane>? DOS 

Preferred clock <L>? 

Choose the clock which? if available? should be used durini^ timesharin;-j, 

TyF>e 'L' to use the KWll-L line fretsuencw clock* 

type 'F" to use the KWll-P r^ro^raminable clock* 
Type <LF> for no chanf^e* 

Preferred clock <L>? L 
Date format <ALPHABET1C>? 

Type 'A' or 'N' to choose the format for the system date* 

Type 'ALPHABETIC for alphabetic date <e*j^* 3:l-Dec-76) ♦ 

Type 'NUMERIC for numeric date <e*<.^* 76*12*31)* 

Type <LF> for no chan«3e* 

Date format <ALPHADETIC>? A ■. 

Time format <AM/PM>? 

Type 'AM' or '24' to choose the format for the system time* 

Type ' AM/PM ' f o r AM/PM f o rmat time < e ♦ «3 ♦ 1 J 30 PM ) ♦ 

Type '24--H0UR' for numeric time <e*<^* 13J30). 

Type <LF> for no change* 

Time format <,AM/PM>? AM/PM 

Power fail delay <1>? 

When power is restored after a power failurer FtSTS/E will 
delay the recovery for 1 to 300 seconds to allow all 
devices to become ready* Specify the number of seconds 
you want to delay* 

Power fail delay <1>? 300 

Option? START 

You currently have J JOB MAX =«= 21- SWAP MAX ■■■■■■■■ 2BK* 

JOB MAX or SWAP MAX chansies? 

JOB MAX or SWAP MAX may be chani^ed as follows J 

1) JOB MAX may never be sireater than 2y which is the Job maximum 
specified at system fcleneration time* 

2) SWAP MAXk which is expressed in K of memory <1K™1024 words) v may 
never be sfreater than 31 <K) or less than 8 (K)* 

3) Each of the four possible swap files can hold N Jobsi' where 

N ™ [;Si2:e of swap file (in blocks ):i / IISWAP MAX (K) >!< Al 
tt'uncated to an intesder* The sum of the N's for the four swap 
files determines the number of Jobs which may lo«S on* This number 
may be increased on line by add in«-l swap files <up to a maximum of 
4» includin;^ SWAP*SYS)» but may never exceed the JOB MAX specified 
at start -UP time* 

4) The one retauired file? SWAP. SYS » must be at least i:SWAP MAX >K SJ 
blocks loni^f so that it can hold two Jobs* 

Type' 'YES' to chansde JOB MAX or SWAP MAX* Type 'NO' to leave the 
maxima as they stand* Any chan<-les? NO 
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Ari\:f m e III a YMai a 1 1 o c i3 1 :L on c h <3 n ?J e s ? 

If wau w:i,sh to specif ^:« a cortain portion of irifsmorw a«» unavailable to 
RSTS or as dedicated buffer spacer or if you wish to locate the Run Time 
System at some special addr^ess (.B*«i* in MOB meiiior«:Oy answer 'YES'* To 
leave the memory allocation unchan<^ed from the l«->st specified tables- 
answer 'NO' ♦ 

Any memory allocation chan<^es? NO 

You currently have crash dump enabled* 

Crash dump? 



Type 'YES' to enable crash dump at startup 
Type 'NO' to disable crash dump* 

Enable crash dump? YES 



time* 



22-A 

Eiinte 

or a 

06 J 3 

Ente 

or 

UFO 

DSO 

DBl 

DLO 

DLl 

DM0 

DMl 

DPO 

DPI 

DRO 

DRl 

DBl 

LPO 

MTO 

MTl 

MMO 

MMl 

MSO 

MSI 



pr--79? 

r date as 'DAY -MONTH -YEAR' <e*!^*y 31-DEC~76) 

s ' YEAR * MONTH * DAY ' ( e * <=f ♦ r 76 ♦ 12 ♦ ;'51 ) ? 22-APR 

2 PM? 

' HOUR t MINUTES AM' or 'HOUR? MINUTES 
format as 'HOUR: MINUTES' (e*.^U 13 J 



r time as 
n 24 -hour 
disabled 
disabled 
disabled 
disabled 
disabled 
disabled 
disabled 
disabled 
disabled 
disabled 
disabled 
disabled 
disabled 
disabled 
disabled 
disablcsd 
disabled 
disabled 
disabled 



•■••79 

PM ' 
15) ? 



< e ♦ ;■! * : 

6 J 32 \ 



U15 PM) 
•'M 



I "I o l-\' I" ♦ (:^ o I "I t r o 1 1 e r 

i-i o I"? S ♦ CO I "r t r o 1 1 e r 

i"i o R S ♦ c o n t r o 1 1 e r 

n o R l,_ ♦ c o i"i t roller 

no RL* controller 

n o r-; M * c o n t r o 1 1 e r 

no RMt controller 

no r*: 1=' ♦ c o n t r o 1 1 e r 

n o R P ♦ c o i-i t r o 1 1 e r 

i"i o R R t c a n t r o 1 1 e r 

no R R * controller 
u n i t ri o t p r e s e ri t 

no LPO* controller 

no TM* controller 

n o T M ♦ c o n t r o 1 :i. e r 

no TU * con t ro Her 

ri o T U ♦ c o i"i t r o 1 1 e v 

no MSOt controller 

no MS 1 ♦ cont r o 1 1 e r 



19 devices disabled 

?Can't find file or account 

, M 1..I N "f ■ 1:1 K t S Y S Q N / 1^' (.) 

,R DKO J CREATE* SAM 



"C 

HELLO 1/2 

Password* 

1 other user is 1 eroded in under this account 



♦ASSIGN DKO: IN 

*R in:pip*sav 

*SY : $* * *<232>===:IN : 1IH...0GIN * SAV y ^LOGOUT ♦ SAV y $PIP * SAV 
*SY t $* * »«104>-==IN J HiUTILTY ♦ SAV 

*S Y J $* ♦ *< 1 04>=- 1 N I *MACRO ♦ SAV y *CREF ♦ S A^^ y *L I NK * SAV 
*SY : $* * >I«104>-=:=1N J *SILUS * SAV y *HOOK * SAV y *SYSGEN * SAV 
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*£)Y 
*i;iK 
JtcQY 
*SY 
*SY 



: ** ♦ >K<124>='<I:N J HiSYSBAI , SAV 

: $* . *<104>==<tN J $ONLPAT ♦ 8AV 

: $* ♦ *< 40>™ I N t HiERR ♦ STB f W 1 PS A V ♦ TXT 

J 1:0 y :l .1* ♦ *<40>==':I:N t iliTECO * RTS 

J CO » 1 n* ♦ )K/MO t :i6==sY : i:;o y :i. [jteco ♦ rtb 

: $* ♦ *<3,04>/RTS t TECO-'IN J $TECO ♦ TEC 



♦ DEAI3B.IGN IN 

♦ DISMOUNT riKOJ 

♦R LOGOUT 

Confinn: Y 

Savod all disk f.*Lle<»? 576 blocks in use 

Jab 2 User :l. y2 lo.«!<3ed off KBl at 22-Apr"79 06:33 PM 

1 o t hi! e r u «► e r s t :i. 1 1 1 o i-i si e d i ri 1..1 r-i d e r t f » :i. s <•> c? c o u i"i t 

S'JSteiTi RSTS V7»0"07 RSTS/E SYSGEN 

Run time was 3 seconds 

Elar-'sed time was 1 minute 

Good eveninsi 



*>K22-A>^r-79*>K 



Beslinnind of RSTS/E system jJeneration* 



Questions come in larns and short foY'ms* 
If vj o u a r e f a m i 1 i a r w i t h t hi e in y a n s w e r 
"S" for shorty otherwise y answer "L" for 
lon^a form* 



Form ? 



*S # 



The system will automatically suj-'fIw 
answers to all of its prom>"'ts* You have 
the option of accept inii? the answer y 
supplwinjif a different answer y or 
re«uestin?J the full printed message* The 
hardware answers will be meaningful only 
if you BVi-i fiienevatini^ a system for the 
computer that you are currently runnin;.-? 
on* If you mre .^eneratin.<-S a system for 
th i s compute r y type " YES " y othe rw i se y 
type "NO", 



Same system ? 



#Y # 



The RSTS/E sv:*stem is distri butted on 
maiatapey RK05 <»K)y RLOl (BL)y and RK06 
and RK07 (DM) cartridile disks? or may 
already have been transferred to the 
system disk < S Y ) » For m a .*■! t a p e y a d i s • - 
ti net ion must be made between the TUlOy 
TElOy and TS03 drives y which use the 
device name "MT"y the TU16y TE16y TU4Sy 
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and TU77 drives y which use the device 
name "MM"? and the TS04 drive? which 
uses the device name "MB"* Enter the 
twi^e of distribution medium for this 
swstem .'feneration (Mix MMy HSy DKy DLc 
riMf or BY) ♦ 

Distribution medium ? #DK# DK 

The £iene rated system can be written onto 
the current system disk (BY) J another 
disk drive <DFr DK» DL» DM» HP, DRy or 
DB)5 TU:LOy TElOy or TB03 ma«?tat^e <MT)? 
TU16y TB:16, TUA5t or TU77 mas-ttar-'e <MM)5 
TS04 maj^tape (MB)y or DECtaF'e (DT)» 
Usin^ the current swstem disk <BY) as 
the outFut medium is recommended on:i.y if 
the system type is HM* DPy IiR» or DB« 

Output medium ? *BY# BY 

RF disk drives have limited stora.*ile cap- 
acity. If an RF drive is beinsj used as 
the system disk durin<-j the BYBGEN pro- 
cedure y files will have to be deleted 
from that disk after they are used* When 
the system disk is an RKO'5 or RLOI and 
output to BY has been chosen y files will 
also have to be deleted after they are 
used to leave enou*i<h room for the system 
library* Bhould files be deleted after 
they Bre used (YEB or NO)? 

Delete files ? *NO=B' YES 

If there is a line printer available for 
use durin?-^ BYBOEN it may be used to 
print the system load maps andy 
o p t i o n a 1 1 y y t o p r i ri t a s s e in b 1 y 1 i s t i n <;i s 
of the system tables and terminal 
service modules* If you ha^e a printer 
art*i want the assembly listin<iJs and/or 
load maps printed durin<-l BYBOEN y answer 
"YES"* Otherwise answer "NO"* 

LP for BYBOEN ? *NO»c NO 

This pro«<ram can be used to j^enerate a 
monitor and/or a BABIC-PLUB Run -Time 
System* Do you wish to .'Generate a 
monitor (YEB or NO)? 

Generate monitor ? *Y =B-- YEB 

The monitor Save Imas{e Library (BID 
will have a name of from 1 to 6 alpha- 
numeric characters and an extension of 
"SIL"* Pl<?ase specify the name you want* 

Monitor name ? *RBTB* RSTSV7 

The system feneration process can auto- 
matically patch the .'•Sene rated monitor* 
You must have a monitor patch file on 
any RSTS/E file structured medium* Would 
you like to automatically patch the 
fjenerated monitor <YEB or NO)? 
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Monitor r-»tch:i.n«« ? *??# NO 

You have the option of j^one ratine the 
BASIC-PLUS Run-TiiTie Swstem in addition 
to sienoratin'J the monitor* Ho wo«..i want 
to -Generate BASIC -PLUS at this time 
<YES or NO)? 

Generate BASIC-PLUS ? ^Y * YES 

The )Et ASIC -PLUS Save Ima*^e Library (SID 
will have a name of from 1 to 6 alpha- 
numeric characters Biid an extension of 
"RTS"* Please specify the name wou want* 

BASIC-PLUS RTS name ? f BASIC* BASIC 

The swstem <Jeneration process can auto- 
mat i call w patch the .'Generated BASIC- 
PLUS* You must have a BASIC-PLUS patch 
file on same RSTS/E file structured 
medium* Would wou like to automatically 
patch the Generated BASIC-PLUS (YES 
or NO)? 

BASIC-PLUS patch injd ? #??# NO 

You have the option of install in<-i PSX 
or BASIC-PLUS-2 as the system default 
run-time system* Will you want RSX as 
the system default run -time system 
(YES or NO)? 

RSX as default RTS ? #N0# NO 



Now you must specify the hardware con- 
figuration on which this RSTS/E system 
will run* 



The next few Questions deal with the 
numbers and types of terminal interfaces 
on the system* 

Serial ASCII terminals connected direct- 
ly to the computer ctnd those connected 
throuslh leased private telephone lines 
(not dial-up) may use (hither of two 
classes of sin<.^le line interfaces (or 
s e V e r «■} 1 m u 1 1 i p 1 e x e r s r d i s c u s s e d 1 a t e r' ) * 
The first class includes the KLlls- LCliy 
DLllA)' and BLllB interfaces* Specify the 
total number of these sin<^le linos inter- 
faces (1 to 16 - include the console 
terminal ) * 

KLll»LCllfBLllAyBHlB's ? ^Ol* 1 

The second class of sinsJle line inter- 
faces used to connect terminals locally 
or through leased telephone lines (not 
dial-up) includes the BLllC and BLllB 
interfaces* How many BLllC 's amd BLllB's 
are on this system (0 to 31)? 
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IiLllCy DLiUD's ? *00* 

There are two kinds of individual inter- 
faces for automatic answer da tasets used 
on the di al-ur^ tele»"'hone network* The 
first of these is the DC:I.:L* How manw 
DC 11 -DA lines do wou have <0 to ;'52)? 

DCll's ? *00>K 

The second kind of individual line 
dial-up interface is the DLllE* How mi-in'd 
D L 1 1 E-: ' s a r e o i"i t h i s s vi s t e in < to 3 1 ) ? 

DLllE's ? >K02* 2 

Each DJll multiplexer can connect up to 
16 terminals to the system* Please enter 
the to t <••> 1 n 'J m b e r o f D ,.) 1 1 ' s a 1 1 a c h e d t o 
this system (0 to 1A)« 

DJll's ? >KO(»K 

Each DHll multiplexer can connect up to 
16 t e r m i n a 1 s t o t h e s v.j <■> t e m ♦ P I e <:> ii> e e n t e r 
t h e t o t B 1 I'l u in b e r o f D H 1 1 ' s a 1 1 a c h e d t o 
t h i s Sj w s t e m < t o 16) ♦ 

DHll's ? *00* 

Each DZll multiplexer can connect up to 
B terminals to the system* Please enter 
t h e t o t a 1 n u m b e r of D Z 1 1 ' s a 1 1 a c )) e d t o 
this system (0 to 16) ♦ 

DZll's ? >K02* 2 

For this DZll unit* enter the number of 
lines which will be used now or in the 
forseeable future* A response of 8 will 
permit all lines to be used* If the num- 
ber of lines enabled <n) is less than Bv 
RSTS/E will not be configured for and 
will not recojdnize lines n thru 7 on 
this DZll unit* Enter the number of 
lines enabled (0 to 8)* 

DZll unit 00 lines enabled ? *08# 8 
DZll unit 01 lines enabled ? #08* 8 

The DZll-A and DZll-B include partial 
m o d e m c^ o n t r o 1 y w fi i 1 e t h e Jti Z 1 1 - C a n d 
DZll-D do not* If you have a DZll -A or 
DZll-B and wish to include support 
for datasets on DZll's answer "YES". 
1 h e r w i s e a n s w e r' "NO"* 

Dataset support for DZll's ? *N0# YE* 

Pseudo keyboards permit interactive vjobs 
to be run without tyin.<;} up a real termi- 
n a 1 * T h e \:! a r e p r i m a r i 1 y i i"i t e ri d e d f o r u s e 
by a batch control prosJram which feeds 
commands to one or more pseudo keyboards 
dedicated to runnin<-« back .*„={ round tasks* 
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How manw pseudo ke^ijboards would ".-.fou like 
to have <:l to 127)? 

Pseudo kewbaard«> ? #04* e 

RSTS/E :li3 capsblo? of support irujs IBM 2741 
compatible tiarminals on DLllIiy DL 1 1 E y 
and DC 11 t>:Ln«{l© line interfacesy or on 
UHll or DZll multiplexeriii* If v^ou do not 
want Bn\:{ 27 A 1 s i..i p p o r t t h e n a n <» w e r "NO** 
Otherwi<5e answer "YEB"* 

2741 support ? *N0* no 

An optional feature of the RBTB/E termi- 
nal service allows onfs Job to interact 
with several terminals throuj'lh special 
forms of the Record 1/0 GET sud PUT 
statements* This feature is useful in 
applications where the same basic func- 
tion is performed on several terminals 
&rid a separate Job for each is undesir- 
able or at least inefficient* Would you 
like to include this feature (YES or NO)? 

Multi -terminal service ? #Y * YE!:> 

Echo control is an optional feature of 
the RSTS5/E terminal service which allows 
any full duplex terminal to function 
like a bio c k in o d e t e r' in i ri a 1 ♦ T h i s f e a t i..i r e 
enables a prosiram to define fixed leni^ith 
input fields and to defer echoin.<-{ of all 
typed characters until they are actually 
requested* It is useful in data entry 
applications or wherever the appearance 
of terminal output must be precisely 
control Ited* Would you like to include 
this feature in your system (YES or NO)? 

Echo control ? *Y # NO 

The RSTS/E terminal service can be built 
to respond to CTRL/T by printin<i< a one- 
line status report describiiU'i the viob's 
status* This report includes the Job 
namec RTS name? run state » Job Bnd RTS 
sisesy Bnd total Bnd incremental CPU 
times* The Job is not disturbed when the 
report is printed* Would you like to 
have this feature in your monitor (YES 
or NO)? 

One- line status report ? #Y * YES 



The next Questions deal with the numbers 
a n d k i i"i d s o f d i sk units o ri t fn. s s y s t e m ♦ 

The RTll controller is used to control 
UP to 8 of the RSll 2'56K word fixed-head 
disks* If this sv«stein has none of thosse 
disks y answer NO J otherwisey answer YES* 

RF/RSll's ? HcNO* NO 

The RS04/RS03 disk system consists of Bn 
RHll device controller and from one to 
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ei^ht RSOl? <2S6K) or RSOA <512K word) 
fixed -head disk drives* Please enter the 
to tail, number of RB03 and RSO-^ drives on 
this system (0 to B)* 

RS03/RB04's ? HcOO* 

The RKl:l. controller is used to control 
UP to B of the RK05 1»2 million word 
movin*=i-head cartridge disk drives* Note 
that an RK05F is equivalent to 2 RK05's» 
How many RK05 drives are there <0 to B)? 

RKOS's ? #0B* 2 

By usin.'iJ the overlapped seek driven- wou 
can increase the efficiency of disk I/O 
at the expense of some memory* Type 
YES to u s e t h e o v e r* 1 a p p e d see k d t' i v e r ♦ 
Type NO to use the non-over lapped seek 
driver* 

Overlapped seek ? *Y * YES 

The Rl...l;l controller is used to control 
any combination of up to four RLOl <2*A 
million word) or RL02 (5*2 million word) 
top loadin.«{ cartrid«Je disk drives. Enter 
the total number of RLOl and RL02 drives 
on this system <0 to 4)» 

RL01/RL.02's ? *00* 

The RK6l:L controller is used to control 
any combination of up to eidht RK06 (.6 
mill i on word ) o r RK07 ( :l 2 m i 1 1 i on word ) 
top loadin<^ cartrid^Je disk drives* Enter 
the total number of RK06 and RK07 drives 
on this system (0 to B)* 

RK06/RK07's ? *00)K 

The RP:l:l. controller is used to control 
a n y c o m b i i"i a t i o n o f ' up t o e i m h t R P 2 (10 
million word) or RP03 (20 million word) 
movin^^-head disk pack drives* Enter the 
total number of Vi:P02 and RP03 drives on 
this system (0 to B). 

RP02/RP03's ? *00* 

The RM02/3 disk system consists of sn 
RHll controller and up to eijilht RM02 
or RM03 movinfJ-head disk pack drives* 
Type the total number of RM02 or RM03 
drives in this conf ij^uration (0 to B)* 

RM02/RM03's ? *00* 

The RFO A/'5/ 6 disk system consists of an 
RHll controller and any combination of 
UP to eissht RP04 (44 million word)y RP05 
(44 million word)? or RP06 (80 million 
word) movin;^-head disk pack drives. Type 
the total number of RP04j- RP05? and RP06 
drives in this configuration (0 to 8)* 
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RP04/RP0bVRP06's ? >KO:l.* 



The next few c»uestioni» deal with the 
p-eripheri^l devices attached to this 
RSTS/E iswstem ♦ 

The TU16/TE16 maj-Jtape system consists of 
an RMli massbus interface y Tii02/TM03 
controller &rid from one to ei^Uit TU;L<f>y 
TE16» TU4Sy or TU77 drives* If this 
system has no TUlAy TElAy TU45y or TU77 
maEitape drives answer 0? otherwise y how 
many TU:l6y TE16y TU45y and TU77 drives 
exist on this system < :L to 8)? 

TUi6/TE:L6/rU4S/TU77's ? JKOO* 

The TMll/TMAll/TMBll magtape controller 
can support up to eifJht TUiOy TElOy or 
TS03 ma;»^tape drives. Please enter the 
number of TUlOy TElOy and TB03 drives on 
this system <0 to 8>» 

TU10/TE10/TS03's ? *00* 

The TS04 ma^ltape swstem consists of a 
TSll controller and a TS04 drive. RSTB/E 
supports UP to 8 TS04 systems. If this 
system has no TS04 ma;-ltape drives answer 
Oy otherwise y how many TS04's exist on 
this system (1 TO 8>? 

TS04's ? *00* 

The TCll HECtape controller can control 
UP to 8 sinsile drives. If this system 
has no DECtape at ally answer 0? other- 
wisey how many sin.^le DECtape drivesy 
not TlJ56'sy are there CI to 8 •- note 
that each TU56 dual drive has 2). 

DECtapes ? *00* 

The TU58 DECtape-II system consists of 
two drives and a control lery connected 
throu'^h a DLll interface. RSTB/E sup- 
ports UP to four TU58 systems for a 
maximum of eisiht drives. Please enter 
the number of TIJ58 drives attached to 
this system (0 to 8). 

TU58's ? *00* 

The RBTB/E system can have up to eix^ht 
line printers of the LP:Ll.y LBily or LVll 
type. These printers are referred to by 
the device names LPO. throu.^h LP7.. If 
there is no line printer y answer OP 
otherwise y enter the number of printers 
<1 to 8). 

Printers ? ^OO* 

The RXll or RX2;L1 floppy disk system 
consists of a UN I BUB interface and an 
RXOl <sin<^le density) or RX02 (double 
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deniiiiby) floFPW disk subsvjstojin* The R'XO:l 
and RX02 each include « disk controller 
and two floppw disk drives* RSTS/E 
supports UP to four RXll or RX2:l:l 
systems for a inaxiinuiTi of ei.<^ht drives* 
Please enter the number of floppy disk 
drives a 1 1 a c h e d t o t h i s s vj ii> t e in < t o 8 > ♦ 

RX01/RX02's ? )KOO>K 

Does this system have a CRl.t punched 
card reader or a CM:1. 1 marked card reader 
<YI-:;S or NO)? 

CRl:l/CM:l.:l card reader ? *NG* NO 

Does this system have a CD 11 hij^h- -speed 
punched card reader (YEB or NO)? 

CDll card reader ? >KNO* NO 

Is there a histh-sp-eed r^'BY-'er tape reader 
(YIE:S or NO)? 

FM* reader ? *N0* NO 

Is there a hi<ijh -speed paper tape punch 
(YES or NO)? 

P»T» punch ? ' *N0* NO 

The DMCll network link is a synchronous 
c o in m I..I n i c a t i o n 1 i ri e i ri t e r f a c e w h i c h i m p •- 
lements the DDCMP line protocol in hard- 
ware* At least one unit is required for 
D E C ri e t <: o m m u n i c a t i o n <•> ♦ l-l <:) w in a I'l y D M C 1 1 ' s 
are attached to this system <0 to 16)? 

DMCll 's ? )K04* 4 

DECnet/E is a set of modules which imp- 
lement the network services protocol 
a\-\d user interfaces required for DECnet 
communication* The DECnet /E software is 
sold and distributed as a separate pack- 
a!.^e* It is not includosd in the standard 
RSTS/E kit* Do you have a DECnet/E kit 
and wish to include DECnet support in 
this system <YES or NO)? 

D E C; n e t n e t w o r k «> u p p o r t ? * Y # Y 

The DECnet/E packasSe is distributed on 
ma«itape? RK05 (DK)y RLOl (DL)y and RK06 
and RK07 <DM) cartrid<-^e disks? or may 
already have been transferred to the 
system disk <SY)* For maj'^tapei' a dis- 
tinction must be made between the TUlOy 
TElOy aud TS03 drives? which use the 
device name "MT"? the TU16y TEIAk TU4I5!' 
and TU 77 drives* which use the device 
name "MM"? and the TS04 drive y which 
uses the device name "MS"* Enter the 
type of distribution medium for this 
DECnet/E iv^eneration (MT* MM? M8y DKi* DLy 
DMy or BY) * 
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DEC rt e t / E d :l b t y' i b u Iv ,i. o n in e d :i. u in ? 



I=DK# 



DK/A 



The «>wi3tein ;;!enerat:Lari process can iuuto •• 
in a t :l c^ a 1 ;i. vf r- <•} t c h l, >i e .<;^ e n e yn» t e d D I--; (!) n e t / 1::,' 
support* You must have a DECnet/E patch 
file on 3i"iw RSTS/E fiile structured 
medium ♦ Would wou Like to automat :lc a :i.:i.w 
patch the DECnet/E support (YEB or NO)? 



i:iECnet/E patch :Ln«S ? 



*??■# 



NO 



The KMC:l. :l. is &i"[ :lnte:U.i?^ent micro- 
pro c B s s o r c o n t r o 1 1 e r* w h i a h 9 w h e ri 1 o b d e d 
with appropriate micro-codes y can be 
used to control various twpes of peri- 
pherals* How many KMCll units do s.tou 
have on this system (0 to 16)? 



KMCll 



'? 



*0:l* 







The LI"' driver can be made to take advan- 
ta<^e of the extended buffer pool rather 
t h a n a 1 w a si s b u f f e r :i. ri sj c h 3 r a c^ t e r o u Iv p u t 
from t h e s in all b u f f e r p o o 1 ♦ Th i b w i 1 1 
particularlvif benefit those systems which 
have isn increased contention for system 
small buffers* Do wou want the extended 
bufferinx^ for LP (YES or NO)? 



Eiix tended bufferin?-? for LP 



=II=Y * 



NO 



The R9TS/E 2780 packa<Se emulates the 
operation of the IBM 2780 Model 1 data 
transmission terminal* Tho? packa<i?e per- 
mits the RSTB/E swstein to communicate 
with anw I DM swstem which supports the 
devices or another RSTS/E 2780 system* 
The 2780 packasJe is sold and distributed 
as a s e p a r a t e p a c k a ?■$ e ♦ 1 1 is not i n c 1 u d e d 
in the standard RBTS/E kit* Do wou have 
the 2 7 BO packa?-le and wish to include it 
in this system (YES or NO)? 



2780 support ? 



#NO=l 



NO 



The remain infii{ <suestions deal with the 
capacity and features of this FJ;STS/E 
system provided at the system inana<^er 's 
option* 



An optional feature of RSTS/E is the 
ability to read and write files which 
are lonj^er than 65S35 blocks* Tncludin?.-J 
larsie file support also reduces file 
creation and access times and makes 
disk update mode si.<;inif icantly faster* 
Includin<.-J lars^e file support will make 
your monitor 2K lar^dery and will use 
more small buffers for each open file* 
Do you want vjour system to handle lar?-Je 
files (YES or NO)? 



La ride files ? 



*Y # 



YES 



With sufficient hardware RSTS/E can han- 
dle UP to A3 simultaneous Jobs* What is 
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the maXiinuiTi number of Jobs (JOBMAX) to 
be used at this installation <1 to 63)? 

Maximum Jobs ? *10* 20 

Small buffers are 16 word blocks in mon- 
itor stora.«{e that are dynamically allo- 
cated as input Bnd out^^ut buffers !» file 
parameter b locks r etc* Sto ra?.-{e maw be 
allocated for 30 to 999 small buffers* 
The recommend<:jd minimum is at least 10 
for each possible Job* How many small 
buffers would this installation like to 
have (30 to 999)? 

Small buffers ? #260* 260 

Lo'^ical names can be assij-ined to devices 
on a system wide basis* The assi«<nment 
table consists of five words for each 
assii^nment* Please ento;?r the maximum 
number of system widos lo.<.={ical assi?^n- 
ments that will be in use at any one 
time (5-50)* 

System wide lo<^icals ? #10* 10 

You can add special statistics <Jatherin«^ 
code to the monitor* This code includes 
tables that record Job and disk transfer 
statistics* Would you like to include 
the statistics sia the rind code (YES or 
NO)? 

Monitor statistics ? *N0* NO 

An optional feature of the R'STB/E system 
allows the file processor (FIP) to use 
free buffers? or dedicated sections of 
in e III o r y (called t h> e e x t e n d e d b u f f e r pool) 
to store d i r e t? t o r sa i n f o r m a t i o n * T h i s 
improves the speed of directory process- 
in^ by not rereadinsj freouently accessed 
directory information* If you want FIP 
bufferings type YESr otherwise type NO* 

FIP bufferings ? #Y f YES 

An extended version of FIP bufferinj^ is 
available under RSTS/E which allows Jobs 
to specify ii on a file by filf? basis r 
that user data files are to be cached in 
the extended buffer pool* This cachini'J 
is in addition to the FIP directory 
bufferin'iJ* Extended data bufferin?.^ can 
also cache clusters of datay and do read 
ahead of user data* It retsuires you to 
allocate at least 2K words to the 
extended buffer pool. Do you want to 
include extended data buffer in<-$ in your 
system (YES or NO)? 

Extended data bufferinrJ ? #N0* NO 

At the cost of a physically lar<^er 
monitor!' the disk drivers and their 
subroutines can be built into a separate 
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man i tor "phase** If you want to inajrlinize 
the Biz& of wour small buffer poolv wou 
shou 1 d answe r " YES " ♦ Bu .1 1 d mon i tor w i th 
a separate disk driver r"'hase< YES or NO)? 

Disk driver phase ? #Y # NO 

An optional feature of RBTS/E allows 
prosJrams to reduce I/O for overlawin?.-! bw 
attach in<^ to shareable memo rw -resident 
code* If wou have at least 124K words of 
memor'jy &nd intend to use the RMS-llK 
Resident Library* answer 'YES'* 

Resident libraries ? *Y * NO 

The RST3/E monitor can be made to take 
over some of the function of the RSX Run 
Time System* Prcvirams which normally run 
under the RSX Run-Time System don't rieed 
any run time system y so they can j.-irow to 
^IKi- or use the address space for a 
resident library* This option makes the 
monitor about IK lar<ser* Do you want to 
include RSX directives in your monitor 
(YES or NO)? 

RSX directives ? *NO>K NO 

If there is sufficient memory available 
on this system!- the most frequently used 
non-resident disk handlin«J code can be 
made resident in order to provide better 
system performance* Should this disk 
p r o c e s s i n .^ b e d o i"i e b vrf r os s i d e n t code ( Y IE S 
or NO)? 

Resident disk handlin<-$ ? =I1=Y # YES 

The routines to implement the simple SYS 
calls are normally non-resident* Overall 
system performance can be improved by 
makinsa this code resident* Do you want 
the simple SYS call code resident (YES 
or NO)? 

Resident simple SYS calls ? *N0* NO 

Non-resident code is used to delete or 
rename a file* If you want the file 
delete/ rename code to be resident type 
"YES'f otherwise type "NO** 

Resident file delete/ rename ? #N0# NO 

Non-resident code is used to do lo;.^insy 
attaches? Bnd as s i jS n a 1 1 r i b i..i t e s * If y o '..i 
want the Ic^in* attache Bnd attribute 
code resident* type "YES"* else answer 
"NO"* 

Res* lo^in/attach/attribute ? *N0* NO 

Non-resident code is used to list disk 
directories (CATALOG command) B\"td do 
file lookups* If you want the directory 
lister and file lookup code resident* 
type "YES"* otherwise answer "NO"* 
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Resident catalosi/. Lookup ? #N0* NO 



The follow.i.rij-i Questions deal with the 
BASIC -PLUS run- "t:!. me system 

Will this software rM.jn on a computer 
with a floatin?-{ point processor (YHS 
or NO)? 

FPF' ? )KNO* NO 

Will this software run on a computer 
with the floatin<-« instruction set 
(YES or NO)? 

FIS ? )|cNOH( NO 

F 1 o a t i I "I ?J p o i ri t i"i i.,i in b e r s a r e r e p r e s e i "i t e d 
i ri t e r n <n 1 1 SJ a <r> (', w o 1 6 ■■■■ b i t w o r d s ? <.i i v i rr ^-i 
seven sitlnificant di<=fits» lb is possible 
to maintain 17 si'^jnif icant di*:iit<-> bw us- 
insJ 4 words >-'er number* The four word 
math packa?iles also include the scaled 
a r i t h m e I i c f e a t u r e ♦ W o i..i 1 d t li i *r> i n s t a 1 •- 
1 at ion prerf'er to use 2 or A word math? 

Math precision ? #02# 4 

It is possible to save space in the 
BASIC ••••PLUS system b\j omittinsi the lo.'.^a-- 
ri thmic functions SQR f EXP y L0(3 y and LOOK) j- 
if thew are not needed tBoes this instal^- 
1 at ion need to compu^be these functions 
(YES or NO)? 

Lo;.S functions ? *Y # YES 

It is possible to save space in the 
BASIC -PL US system by omittinjJ the tri^So- 
nometric functions SINcCOSyTANy and ATNy 
if they are not needed*. Does this instal- 
lation need to compute these functions 
(YES or NO)? 

Triid functions ? #Y # YES 

Special oubpub •rormabbin.«? can be done 
usind the "PRINT USING" statement* 
Would this installation like to have 
this optional feature (YES or NO)? 

Print usin<^ ? #Y # NO 

BASIC -PLUS permibs bhe user bo operabe 
on an entire mabrix usin.<.=! Jusb a sin«,-{le 
statement* These statements are the 
"MAT" statements* Would this installa- 
tion like to have bhis optional feature 
(YES or NO)? 

Matrices ? #N0# NO 

An optional feature of BASIC-PLUS allows 
arithmetic operations to be performed on 
numbers rep resenbed by strinjiis* This 
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feature can be use^d to obtain ;Jr eater 
accuracy :i.n arxthinetic oj^erations* Do 
Hou want strinj'i arithmetic (YES or NO)? 

Btrin«-S arithmetic ? *N0* ND 



The s^jstem .'ifeneration dialo.<i{ is finish- 
ed* If wou have Bn^d special recsuirements 
which retauire editinsf the rJene rated file 
CONFIG f MAC (swstein confi .'duration file) or 
SYSOE."N,CTL< batch control file) wou ma«:; 
do it now* When readw twpe "R BYBBAT"* 

♦R SYSBAT 



SYSGEN batch process in?-{ has started 4 
If Bn\:i problems develop durin*-? the batch 
process it maw be aborted bw twpinj;^ 
"Control/C% To restart twpe "R BYBBAT"* 



HELLO 1/2 
Password* 
1 other user is lo<-$.<i{ed in under this account 



♦SIZE 20 

MOUNT AN-C887A-BC (BECNET PACKAGE) ON A DISK DRIME 

READY AND WRITE PROTECT THE DRIVE 

Mount DK J " DECNT A " • -w r i t e I ocked 
Unit ? 1 

♦ASSIGN DKIJ DECNT A 

♦R PIP«SAV 

HOK ♦ >K =^=DECNTA I ir>NSPSUB ♦ OBJ r *NSP ♦ OBJ :- iliNET ♦ OBJ 

JlC'C 



Dismount DKl* 

♦DE ASSIGN DECNT A 



MOUNT AN~277:I.G~BC ON A DISK DRIVE 

READY AND WRITE PROTECT THE DRIVE 

Mount DKfSYSGNG" -write locked 
Unit ? 

♦ASSIGN DKOJ SYSGNG 

♦ASSIGN SYSGNG? IN 

♦R PIP*SAV 

** ♦ *===IN J ^COMMON ♦ MAC 

*SY : $* ♦ >K/PR : NOWARN'^IN J $SYSLIB ♦ OBJ 
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)|c*»*:='INJi|50<^LHD«0BJ 

** ♦ *-"IN J *LIBR ♦ SAV » *PATCII » SAV y *PAT ♦ SAV 

**.*:::! IN J *m:[ncop*bas 

♦ R P.TP,SAV 

*TBL * OBJ y TTDINT ♦ OBJ y TTBVR ♦ OBJ/DE J NOWARN 

>(<TBL ♦ LSI y TTDINT ♦ LST y TTDVR ♦ LBT/DE J NOWARN 

*RSTS ♦ SM y TER ♦ SA V y »3K , SA V/DE J NOWARN 

*EMT . SAV y FIP ♦ SAV y RSX ♦ SAV y OVR ♦ BAV/DE t NOWARN 

*RSTB ♦ MAP y TER ♦ MAP y BBK ♦ MAP/DE J NOWARN 

*EMT ♦ MAP y FXP ♦ MAP y RBX ♦ MAP y 0<^R ♦ MAP/DE I NOWARN 

*RBTS ♦ BTB y TER ♦ STB y DSK ♦ BTB/DE J NOWARN 

*EMT ♦ STB y FXP ♦ BTB y RSX ♦ BTB y OVR ♦ BTB/DE : NOWARN 

)KNBP ♦ BAV y TRN ♦ BAM y XMDVR ♦ SAV y R J27e0 ♦ BAV/DE : NOWARN 

*NSP ♦ MAP y TRN ♦ MAP y XMDVR ♦ MAP y R J27e0 ♦ MAP/DE t NOWARN 

*NSP ♦ BTB y TRN ♦ STB y XMDVR ♦ BTB y R J27B0 ♦ BTB/DE iNOWARN 

♦R MACRO ♦BAV 

)KTTDVR-==:[N : ^COMMON y ^KERNEL y DK t CONFIG y IN : *CHECK y *KBDEF y *TTDVR 

ERRORS DETECTED? 

*'"C 

♦R MACRO. SAV 

5KTTDINT=='=IN J ^COMMON y $KERNEL y DK I CONFIB y IN J iliCHECK y $KBDEF y ^^TTDINT 

ERRORS detected: 

♦R MACRO* SAV 

JlcTBL^-'IN J ^COMMON y $KERNEL y DK t CONFIB y IN J *CHECK y *TBL 

ERRORS detected: 

*"C 

♦r link. sav 

)krbtb/z y rbts/a/w y rstb--:tbl y $err ♦ btb/x/b : 0/e : #20200/u : *:looo/i/c 

jknbpsub/c 

5kttdint/c 

*in:$rstb 

EJC-tend iiiection? MORBUF 
R a u n d «•:> e <: t :i o i "i ? MORBUF 
L. i b r a r *:; s qbvc h ? B Y D 1... R 



Li bran;* 


ir>earch? 


BUF 


Library 


search? 


ALLDSK 


Library 


search? 


DKSEEK 


Library 


search? 




*"C 







.R LINK .BAV 

!«TER/Z y TER/A/W y TER===IN : $TER y DK : RBTB ♦ BTB/X/B : *:l 17000/U : #:LOOO/I/C 

*TTDVR/C 

*in:$rbts 

R a ij n d ir> e c t i o n ? T IE R P A T 
Library search? TTSYBT 
Library search? 
*"C 

♦R LINK. SAV 

*XMDVR/Z y XMDVR/ A/W y XMDVR---" IN : XMP y DK : RSTS . STB/X/B : #1 X 7000/U : #:I.OOO/ 1 /C 

*INJ*RBTS 

R o u i"i d s e c t i on? X M D F' A T 

Library search? XMDVRM 

Library search? 

*"C 

.R LINK. BAV 
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*EMT/Z r EMT/A/W c EMT-^'IN J f EMT y DK t RSTS ♦ BTIVX/e J #1 :17000/U t flOOO/l/C 

*INt*RSTS 

Round 'section? EMTPAT 

Library search? 

♦R LINK^SAV 

*FIFVZ f FIP/A/W f FIP--==IN : HiFlPLRCS 9 DK t RSTB ♦ STB/X/B t #1 17000/U : *:I.OOO/;i;/C 

*INJ$RSTS 

Round section? FIPPAT 

Librarw search? OPL 

Library search? SND 

Librarw search? 



♦R LXNK.SAV 

3KNSP/Z f NSP/A/W f NSP""NSP 

Round section? NBPPAT 



y F IP ♦STB/X/B I #1:17<)00/UMI= 1000 



♦R LINK»SAV 

JKOVR/ZyOVR/A/WfOVR: 

*NET/C 

*:[n:*rsts 



IN? iHOVRLRG f DK t NSP . STB/X/B t # :l. 000/C 



♦R PXP»SAV 

*TBL ♦ OBJ f TTDXNT ♦ OBJ > TTDVR * OB J/DE 

JKNSPSUB ♦ OBJ V NSP ♦ OBJ » NET ♦ OB J/DE 

♦R BILUStSAV 

)|cSYO J CO 1- :l :JRSTSV7 ♦ S II... t TT : -RSTS » TER/M >- EMT/M y FIP/M/C 

*XMDVR/M/C 

*NSP/M/C 

*OVR/M/C 

>KINt*ODT»$DEFALT 

Directors of SIL RSTSV7»SIL on 22~Apr-79 at 07 M2 PM 



Name 



I dent 



-oad 



S i ;s: e Transfer Tot a 1 



RSTS 


07 ♦ 007 


000000 


067000 


000001 


14K 


TER 


07 . 007 


120000 


015000 


000001 


17K 


EMT 


07*007 


120000 


OlAOOO 


000001 


21 K 


FIP 


07*007 


120000 


023000 


000001 


26K 


XMP 


07.007 


120000 


005000 


000001 


27K 


NSP 


OAC ♦ 00 


120000 


020000 


000001 


31 K 


OVR 


07*007 


002000 


100000 


000001 


47K 


ODT 


07*007 


140000 


012520 


142522 


50K 


DEFALT 


07*007 


001000 


002000 


000001 


50K 



Res.ident monitor ^iize is 31K (with 261 small buffers) 

512 small buffers can be added to this swstem <77'i total) 

32 small buffers can be added without a size chanj.^e <293 total) 



*RUN LIBR*SAM 

!KSY X $SYSLIB'=SY J *SYSLIB y DK t OVLHD/U 

*R PIP* SAM 
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*R8TS ♦ SAV r RSTS ♦ SlB/BE 
*TEF\' ♦ SAV f TER ♦ STB/DE 
*EMT ♦ BA V » EMT * BTB/DE 
>KF"II"%SA'v'rFIP.SrB/DE 
>KXMD VR ♦ BAV y XMDVR ♦ STB/DE 
*OVR ♦ BM y OMR ♦ STB/BE 
*NBP . B AV y NBP ♦ STB/DE 

♦ R PJ:i"%SAy 

>KBASIC » SAV y BASIC ♦ STB/BE J NOWARN 

*''C 

»R LXNK^SAV 

*BAB:[C/Z y BAS;i:C/A/W y BASIC=='IN J *RTS y BK J $ERR ♦ STB/X/II t #:L77776/U : *4000/C 

*.i;n:*ma4/c 
>k:[nj*xt4/c 

)KINI$:[0/C 

*.tn:$sn/c 
*:[N?ir>ME 

Round section? PA 
*"C 

»R SILUStSAi; 

>KB AS I C * RTS y TT t :«.B AS I C 

Birectorw of SIL BASIC «RTS on 22-Apr-"79 <3t 07tA3 PM 

Nam GO Ident Load S:i.x!:(? Tran«r>fer Total 
BASIC 07 ♦ 007 :l.04000 07377A 000001 ,1.5K 



)K"^C 

♦ R P.XP»SAV 

*BASIC * BAV y BASIC ♦ STB/BE 

♦ BE ASS I (3N IN 



lismount BKOt 

♦BEASSKSN SYSGNG 

♦R PIP* BAM 

*SYO J i::0 y 1 3* ♦ 5K/M0DE ti6* =^=BASIC ♦ RTS 

*BASIC*RTB/DE 

*"C 

♦ R L0(3GUT 

ConfiriTi: Y 

Saved all disk files y 1008 blocks in use 

Job 2 User ly2 Io.«i<^ed off KBl at 22-Apr-79 07 J 43 PM 

1 a t h e r u s e y* s t i 1 1 I o «$<■{© d i ri u i "i d e r this a c: (.7 o u n t 

Bwstein RSTS y7,0-07 RBTS/E SYSOEN 

Run tiiTie was 12 ininutesy 53 f 2 seconds 

Elapsed time was 17 minutes 

Good evening 
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Batch Job comt-'letG^d* 

♦ R UT.TLTY.SAV 
*N0 LOGINS 
*SHUTUP 



RSTS VyvO-O? RSTS/E BYSOEN <DBO) 

Option: INSTALL RSTSV7 

Option t DEFAULT 

No defaults are currently set in RSTSM7«S:i:L 

You currently havet JOB MAX "" 20 ^ SWAP MAX ■■■■■■■■ :I.6K* 

JOB MAX or SWAP MAX chanjiJes? 

JOB MAX or SWAP MAX may be chan<-{ed as follows? 

:l ) JOB MAX may never bts sfireater than 20 y which is the Job maximum 
specified at system j^eneration time* 

2) SWAP MAX? which is expressed in K of memory (IK"- 1024 words )y may 
never be ai r e a t e v t h a n 3 1 ( K ) or 1 e s s t h a i "i 8 ( K ) « 

3) Each of the four possible swap files can hold N Jobsy where 

N «« CSix'ie of swap file <in blocks).] / INSWAP MAX (K) >K 4::i 
truncated to an inte<-<er» Tho? sum of the N's for the four swap 
files detosrmines the number of Jobs which may lo.<=i on* This number 
may be increased on line by add ini-S swap files (up to a maximum of 
4 * i n c 1 u d i n si S W A P ♦ S Y S ) y b u t in a y i-i e v e r e x <:.* e e d t }» e .JOB MAX s p e c i f :i. e d 
at start - ij p t i in e ♦ 

4) The one required file? SWAP^SYS? must be at least LiSWAP MAX * 3:.1 
blocks lonj^y so that it can hold two Jobs* 

Type 'YES' to chansSe JOB MAX or SWAP MAX* Type 'NO' to leave the 
maxima as they stand* Any ch an «{es? YES 

New JOB MAX? 20 

New SWAP MAX? 

Type 'NO' if you don't want to chani^e the current SWAP MAX* 
To enter a new SWAP MAX? type a number between B and 31 <K)» 

New SWAP MAX? 28 

You currently have J JOB MAX =^' 20? SWAP MAX •■■■•■■■ 2BK* 

JOB MAX or SWAP MAX chan<-les? NO 

R IJ r"i T i III e S y s t e m ? 

Specify the name of the Run Time System to be used as the system 
default* The named Run Time System must exist on the system disk 
in a c c o u n t (.' ? .1. 13 with e x t e ri s i <:> n ' ♦ R T S ' * 

Directory of all valid run time systems* 

RT11*RTS 
BASIC ♦RTS 
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Name of default Run Time Swstem? BAJi>IC 

Error messa««e file? 

Sr-ecifw the name of a file in rOyl^ with extension 'JHiRR' 
which contains the RSTS/E" error messaj;Je text* 

Directory of valid error me<i>tta.'^e files* 

ERF«»ERR 

Name of error messarJe file? ERR 

Installation name? 

Enter the installation name as a strin;^ of up to 15 characters* 

New installation name? Small System 

Memory allocation table* 

OKJ 00000000 - 00173777 ( :ilK> J EXEC 

31K: 00174000 - 00267777 < 15K) : RTS (BASIC) 

A6KI 00270000 •- 007'57777 < 7BK) J USER 

124Kt 00760000 - End t NXM 

Table suboFtion? EXIT 

You currently have crash dumr- disabled* 

Crash dump? 

Type 'YES' to enable crash dump at startup time* 
Type 'NO' to disable crash dump* 

Enable crash dump? YES 

Preferred clock <L>? 

Choose the clock which r if aval lab ley should be used durins-5 timesharin.<d* 

Type 'L' to use the KWll-L line freauency clock* 

Type 'F" to use the KWll-P pro.<i;irammable clock* 
Type <LF> for no chan.<^e* 

Preferred clock <L>? L. 

Date format <AL,PHADET1C>? 

Type 'A' or 'N' to choose the format for the system date* 
Type 'ALPHABETIC for alphabetic date <e*js* 31-Dec"76) * 
Type 'NUMEIRIC for numeric date (e*<;{* 76*12*31)* 
Type <LF> for no chani^e* 

Date format < ALPHABET I C>? A 

Time format <AM/PM>? 

Type 'AM' or '24' to choose the format for the system time* 
Type 'AM/PM' for AM/PM format time <e*i-i* 01 J 30 PM)* 
Type '24-HOUR' for numeric time (e*<-S* 13130)* 
Type <LF> for no chanj^e* 

Time format <AM/PM>? AM 

Power fail delay <1>? 

When power is restored after a power failure? RSTS/E will 
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delay the recovers far :l. to 300 seconds to allow all 
devices to become ready* Specxfw the number of seconds 
you want to delay* 

Power fa:i. 1 delay <:L>? 300 

Option? <;nART 

You currently have? JOB MAX ='=■■ 20 y SWAP MAX «= 2eK» 

JOB MAX or BWAP MAX chan«{es? 

JOB MAX or SWAP MAX may be chan<vfed as follows? 

1 ) J B MAX in a \:{ n e v e r b e <!i r e <i} t e r^ t h a n 20!* w h i c h :i. s t h e J o b in a x i in u m 
s p e <::■ i f i e d a t s \:i s t e in .<•{ e n e r s t i o ri t i m e ♦ 

2) SWAP MAXy which is expressed in K of memory < :LK!"::I.024 words) y may 
never be sjreater than 3:1 <K) or less than B <K)» 

3) Each of the four possible swap files can hold N Jobsi' where 

N ■■•■^ i::8ize of swap file (in blocks) :3 / irSWAP MAX (K) * Al 
truncated to an intej-<er* The sum of the N's for the four swap 
files determines the number of Jobs which may lo<;{ on* This number 
may be increased on line by addin;^ swap files (up to a maximum of 
4 f i n c 1 1..1 d i n d S W A I"* ♦ B Y 8 ) r b u t in a sj n e v e r e ;•( a e e d the ..J OB MAX s p e c i f i e d 
a t s t B r t ■■ • u p t i in e * 

4) The one required filex SWAP* SYS ? must be at least i:SWAP MAX * 8:3 
blocks lonj-jy so that it can hold two Jobs* 

Type 'YES' to chan<-Je JOB MAX or SWAP MAX* Type 'NO' to leave the 
maxima as they stand* Any chan<iJes? NO 

A n \:i m e m o y* y a 1 1 o c a t i o n <:* h a 1 "1 f-i c? s ? 

If you wish to specify a certain r-'ortion of memory as unavailable to 
RSTB or as dedicatosd buffer spacer or if you wish to locate the Run Time 
8 y s t e in <•> t s o in e «> p e c i a 1 a d d r e s s ( e ♦ <^ ♦ i n M S in e m o r* jj ) y a n s w e r ' Y E S ' ♦ To 
leave the memory allocation unch an *-<ed from the last specified table y 
answer 'NO' ♦ 

Any memory allocation chan.«!es? YES 

T a b J. e 11 > u b o p t i o n 'i* I... 1' ST 

M e m o r y a 1 1 o c a t :i. o n t a b 1 e ♦ 

ok: 00000000 •■■• 00173777 ( 3:ik) j exec 

31K: 00174000 ■■■• 00267777 ( 15K) J RT8 (BASIC) 
46K: 00270000 •• 007^57777 ( 78K ) t USER 
124KJ 00760000 •■ End t NXM 

T <!s b 1 e s I..I b o p t, i o n ? X B U I- 

Extended buffer address ran.<^e is? 46Kf8 

Tab 1 e <•> '..i b o p t ion ? E X I T 

You currently have crash dump enabled* 

Crash dump? 

Type ' Y lii: S ' t o e n <"! b 1 e c r a s f » d i..i m p a t star t u p t i m e ♦ 
Type 'NO' to disable crash dump* 
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E-:ri3bIe crash dump? YE£> 

22-AFr-79? 

Enter dirle as 'DAY-MONTH-YEAR' (e^'-j*!- 31-BEC--76) 

or as 'YEAR ♦MONTH* DAY' <e«;-i»y 76*12.31) ? 22-APR-79 

Enter time as 'HOUR: MINUTES AM' or 'HOUR J MINUTES PM' (b*<U ;IJ:I.S PM) 
or in 24-hour format as 'HOUR! MINUTES' <e*<=J* :13J:I.5> ? 8J0«3 f'M 
?Can't find file or account 
? P r o r^ r a m I o s b - S o r r y 

Re^adw 

MOUNT DK0:SYSL1G/R0 

Readw 

RUN DKO:^>BUILD 

BUILD V7*0-07 RSTB V7»<)-07 Small System 

System Build <No> ? YES 

Source Input Device <DKOt> ? ^'^Ot 

Library Output Device <SYJ> ? SYJ 

Tarsjet System Device <SYOJ> ? SYOJ 

Library Account < l'. 1 v 2 "i > ? C 1 r 2 3 

*** Copyinj-? file DKOJ i:::l. i'2::iBUILD»CTL to BLDO:l.*TMP rM 

Locate lo<=$ical ' LB J ' on <SY X Z 1 ? :l. ::i> ? £>Y J C 1. k 208:1 

%Can't find file or account - SYt L::I. y 208:3 

Attempt to create account SYJ i::L y208::i <No::=? 

Account SY: CI 1-200:3 created with your password ,iiti r 

Function (Build/Patchy Patchy Build) <Bui Id/Pa tch:> ? BUILD 

Run-Time System <BASIC > ? BASIC 

Locate ERROR Packa'Se on <SY J i:::l. y2::i:> ? SYU.ly273 

%Can''t find file or account - SYI i:::l. y27:3 

Attempt to create account SYJi::iy27:3 <No:;=? YES 

Account SYJi:::L>27:3 created with your password 

Additional Control File is <None:> ? 

COMP I LE BY t \: 1 y 2 :i BU I LD 

OLD DKO t [: 1 y 2 :3 LOO I N ♦ B AS 

COMP I LE S YO J C 1 y 2 :3 LOO I N<232:> 

OLD DKO 111? 2:3 ATPK ♦ BAS 

COMPILE SYJi::ly2nATPK 

RUN SY:i:iy2:3ATPK 

BLDOl ♦ TMP/RTS 1 110 y 1 :3BASIC ♦ RTS/LOG/DEL 

Ready 



Ready 
Ready 
Ready 
Ready 

Ready 

ATPK V7*0-07 RSTS V7»0-07 Small System 

* 

Ready 
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ASSIGN SYOJSYSDSK 

Readw 

ASSIGN SY J SYSTEM 

Readw 

ASSIGN i:::L)'2:i 

Readw 

ASSIGN DKO: INPUT 

Readw 



! *)K**«)K)K>K*>K BUILD. CTL - STANDARD LIBRARY PROGRAMS 

! Copyri?^ht <C) 1979 b\:t TyifAitstl Ewuilpment Corporation y tia\;m&rdf Mass* 



SCALE 

Readw 

OLD DKO IClf 2 :iCPATCI"l ♦ BAS 

Readw 

COMP I LE S Y J t: :l y 2 J CPATCH 

Ready 

SCALE 

Readw 

OLD DKO J i: .1. f 2 :i AUTOED ♦ BAS 

Readw 

coMF'j LE SY : i:: i v 2 :i autoed 

File ad w 

SCALE 

Readw 

OLD DKO ti:if 2 1 BU I LD ♦ BAS 

Read'4* 

COMP I LE S Y t C .1. >. 2 ::i BU I LD 

Readw 

SCALE 
Readw 
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OLD DKO : i: 1 y 2::i ATPK ♦ BAS 

Ready 

COMF'ILE SYJi:::U2nATPK 

Ready 

SCALE 

Ready 

OLD DKO : L" 1 !- 2;iL0GIN ♦ BAS 

Ready 

COMPILE SYOt CI y23L0GIN<232> 

Ready 

SCALE 

Ready 

OLD DKO t\:if 2 :3L0G0UT ♦ BAS 

Ready 

COMPILE 8Y0 J i: 1 i- 23L0G0UK232:: 

Ready 

SCALE 

Ready 

OLD DKO t r: :l V 2:iPATCPY ♦ BAS 

Ready 

COMPILE SY: til r2:]PATCPY 

Ready 

SCALE 
Ready 

OLD DKO : i: :i i- 2 1 pbu i ld ♦ b as 

Ready 

COMP I LE 8 Y : C: 1 y 2 :i PBU 1 LD 

Ready 

SCALE 

Ready 

OLD DKO ti:if2 3 UT I LT Y ♦ BAS 
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Resdw 

COMPILiE- SYO tZl, limXLlY 

Readw 

SCALE 
Readw 

OLD riKo:r::u2:iiN:i:T ♦bas 

Ready 

COMPILE BY0ji::i»2:nNiT 

Ready 

SCALE 

Ready 

OLD DKO J C 1 y 2 :i SHUTUP ♦ B AS 

Ready 

COMPILE BY0:Cly2:JSHUrUP 

Ready 

SCALE 

Ready 

OLD DKO t Z 1 y 2::iERRBLD ♦ BAS 

Ready 

COMP I LE SYltlf271 ERRBLD 

Ready 

RUN SYtCl»27::iERRBLD 

ERRBLD V7»0-07 RSTS M7«0-07 Small System 

Ready 

SCALE 

Ready 

OLD DK0:i::l»2:iERRINT»BAS 

Ready 

COMPILE SY : C 1 f 27:3 ERR I NT 

Ready 

SCALE 
Ready 
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OLD DKO J i: :l ^ 23ERRCPY * 1E<A£J 

Ready 

COMPILE SY U: 1 » 27 JERRCPY 

Ready 

SCALE 

Ready 

OLD DKO t\:it2 :J D I RECT ♦ BAB 

Readw 

COMPILE SY 1 1:: 1 r 23DIRECT<232> 

Ready 

SCALE 

Ready 

OLD DKO iZlf 2:iTTYSET ♦ BAS 

Ready 

COMPILE SY : C 1 y 23TTYSET<232> 

Ready 

SCALE 
Ready 

OLD DKO : i: % y 21SYSTAT * BAS 
Ready 

COMPILE SY J i: 1. y 2:lSYSTAT<232> 
Ready 

SCALE 

Ready 

OLD DK0:i:i!'2:iEDIT ♦BAS 

Ready 

COMP I LE S Y U: 1 y 2 :i ED I T<AO> 

Ready 

SCALE 

Ready 

OLD DKO J i:: :L y 2:1 ED itch . BAS 

Ready 
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COMPILE SY J t: 1 » 23E»3:TCH<40:: 
Readw 

SCALE 

Re«dw 

OLD DKO 1 1. •it2'J ERRD I S ♦ B AS 

Re£>di:ii 

COMPILE BY J C::!. J- 273 ERRD IS 

Readw 

SCALE 

Readw 

OLD DKO 1 1: :l » 2.1ERRDET ♦ DAS 

Readw 

COMPI LE BY : t: :l. 1 27 2 ERRDET 

Ready 

SCALE 

Readw 

OLD DKO I C 1. 1* 2:J ANAL YS ♦ BAS 

Ready 

COMPILE SYU;i » 27:3 ANAL YS 

Ready 

SCALE 

Ready 

OLD DK0JI::L»23ANALY1»BAS 

Ready 

COMPILE SY :C:.t» 273 ANAL Yl 

Ready 

SCALE 

Ready 

OLD DK0tClf2:i0DT ♦BAS 

Ready 

COMPILE SYU:iy2.10DT 

Ready 
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SCALE 

oij:i DKon::u23REACT ♦basj 

Ready 

COMPILE BY:[:1^23REACT 

Readw 

SCALE 

Readw 

OLD DKO : C 1 y 2 3 REORDR . B AS 

Readw 

COMP 1 LE S Y 1 1: 1?21 REORDR 

Ready 

SCALE 
Ready 

OLD DKO : i: 1 r 2:jdskint . bas 

Ready 

coMF'iLE SY : i: :i. ? 2::idskint 

Ready 

SCALE 

Ready 

OLD DKO J C 1 r 23UMOUNT ♦ BAS 

Ready 

COMPILE SYt [; 1 r2:]UM0UNT<232> 

Ready 

SCALE 

Ready 

OLD DK0JC.ty23C0PY ♦BAS 

Ready 

COMPILE SY J n y2:iC0PY<40> 

Ready 

SCALE 
Ready 
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OLD »K0 : c :u 2 :j F I lcom ♦ b as 

COMPILE BY tilt 2:JFILC0M<40> 
Readw 

SCALE 

Readw 

OLD DIKO : C :l » 2 [IQUOLST ♦ BAS 

Ready 

COMPILE SY J C 1 » 2:3QU0LST<232:: 

Readw 

SCALE 

Readw 

OLD DK0JC1»2:]M0NEY ♦DAS 

Readw 

COMPILE SYJr.1 r2:iM0NEY<40> 

Readvj 

SCALE 

Readw 

OLD DK0JC1»23GRIPE ♦BAS 

Readw 

COMPILE SY J C 1 » 23GRIPE<232> 

Ready 

SCALE 

Read«^! 

OLD DKOJi:ir2:3TALK ♦BAS 

Readw 

COMPILE SY J r 1 r 23TALK<232> 

Readw 

SCALE 

Readw 

OLD DK0Ji:i»23PLEASE»BAS 

Readw 
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COMPILE SY 1 1: 1. y 2:iPLEASE<232> 

SCALE 

Ready 

OLD DK0Jr::l.y2:iINUSE *»AS 

Readw 

COMPILE SY J r::l. y2:iINU£)E<40> 

Readw 

SCALE 
Reodw 

OLD DKo : i:: :l ^ 2 :] s w i tch ♦ b as 

Readw 

COMP 1 LE S Y J i: J, y 2 :i S W .T TCH<2:<2> 

Readw 



RUN SYti;;iy2:ip;i;p,SAV 

*s Y : i: :i y 2::ionlcln ♦ sav/rts t rt:l i =^dko j i: i , 2::ionlcln ♦ bav 



RUN BYji:::i. y2:3P:n"'»SAV 
*s Y 1 1: .1. y 2 J NOT :i: ce ♦ txt<40> 

*SY:i:iy2;]HELP .TXT<40> 
*SY : C 1 y 21 START ♦ TMP='==KB t 
(3SY0:i:d. y2JRTS»CMD 
@SY0n::ly21TTY»CMD 
?(3SP00L*CMDi::l. y2:i 

esYo:c:iy2:iccL.CMri 

DETACH 

RUN SY 

REMOVE 

ADD LOGICAL 

EXIT 

BYE/F 



/PR t NOUARN^DKO J i:." 1 y 2. il NOT ICE . TXT/ AS/NO 
/PR t NOWARN-==DKO tZiv 2::iHELP ♦ TXT/AS/NO 



KBO J 
KBOJ 
KBO J 
KBOJ 
KBOJ 
KBO J 



LOGIN 

FORCE 

FORCE 

FORCE 

FORCE 

FORCE 

ATTACH 

FORCE KBOJ RUN 

FORCE KBOJ :l.00 

FORCE KBOJ NO 

LOGINS 

SEND RSTS/E IS 

END 

>KSY0Ji;iy2:]START 

>KSYJClf2:iSTART 

>KSY0JCly2.1TTY 

*SY0Ji:iy23RTS 

*SY0J[:iy23CCL 

*SYJCly2:.lCRASH 



i:iy2JUTILTY 
LOGICAL LB 

SY J i: 1^2081 LB 



SY J 11x273 ERR I NT 



NOW ON THE AIR 



♦ CTL /PR J NOWARN'=--'SY J IT J. y 2 3 START ♦ TMP/AS 
TMP /DE J NOWARN 

.CMD /PR JNOWARN-:=DKO J III y2:nTY 

♦ CMD /PR J NOWARN==DKO J L 1 y 21RTS 

♦ CMD /PR J NOWARN^'DKO J C 1 y 2.1CCL 
TMP :«KBJ 



♦CMD/AS/NO 
♦ CMD/AS/NO 
♦CMD/AS/NO 
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(asYOti:::!. )'2:iRTj;ucMri 

f^BYOJi::l.v2:3ANALYS»CMD 

0SY0?i::Ly2:]CLEAN»CMD 

(3BY<)JLM»2:;iTTY*CMri 

?espoaL.CMDi::L!»2;:i 
G?eYo:i::i.y2:iccL*CMD 

DETACH 

LOGIN KBOJ 1:1 1-2:3 

FORCE KBOJ RUN SY J C 1 !;2:iUTILTY 

FORCE KBOJ REMOVE LOGICAL LB 

FORCE KBO: ADD LOGICAL BY: i: 1 y20B::iLB 

FORCE KBOJ EXIT 

FORCE KBOJ RUN BYU"! »2:iaUE 

FORCE KBO? Q BY t [il !.27:iANALYB«DMP/DE 

FORCE KBOJ EXIT 

FORCE KBOJ BYE/F 

ATTACH 

FORCE KBOJ RUN BY J 111 y 27::iERRINT 

FORCE KBOJ 100 

FORCE KBOJ YEB 

LOGINB 

BEND RSTB/E IB NOW ON THE AIR»»» 

END 

)|cB YO J 1;: :l V 2:]CRABH ♦ CTL /PR J NOWARN^=BY J C 1 y 23CRABH ♦ TMP/AB 
>KSY J C 1 !- 2:3CRABH » TMP /DE J NOWARN 
*BY J 1: :l. 1- 2:1 ANAL YB . TMP ""KB J 

DETACH 

LOGIN KBOJ i;:iy2:;i 

FORCE KBOJ RUN BY J TJl r 273ANALYB 

FORCE KBO J i::0 y 1 :iCRABH ♦ BYB 

FORCE KBOJ BYJi:ii.273ANALYB»DMP/WIDE 

FORCE KBOJ BYJrii'273ERRCRBJ"IL 

FORCE KBOJ BYE/F 

ATTACH 

-"Z 

>KB YO J 1: .1. y 2:J ANALYB ♦ CMD /PR J NOWARN«=BY J 11 ;l. y 2:3 ANALYB ♦ TMP/AS/NO 

>KSY J C :l y 2:3 ANALYB ♦ TMP /DE J NOWARN 

*BYO J 1:: :l. y 2:3CLEAN ♦ CMD /PR J NOWARN^^'^DKO J i: 1 y 2:iCLEAN ♦ CMD/AB/NO 

*B Y J 1:: 1 y 2 :3 UT I L T Y ♦ HLP «DKO J i: il. y 2 J UT I LT Y ♦ HLP/ AS/NO 

»(S Y J L" 1 y 2 :3 D I RECT ♦ HLP<40:> ^^'DKO J 11 1 y 2 3 D I RECT ♦ HLP/ AB/NO 

>|cS Y J C :l y 27 .3 ERRD I B ♦ HLP -DKO J i: 1 y 2 3 ERRD I S . HLP/ AB/NO 

*SYJi:i. y2JACCT ♦BYB<188:> /PR JNOWARN'^'DKO J CI y2:]ACCT ♦SYB/AB/NO 

>KSY J 1:1 y2:3COPY .HLP<40:> -DKO J CI y2:3COPY ♦HLP/AB/NO 

Ready 

RUN BYJr::ly23UTILTY 

UTILTY V7»0~07 RBTB V7«0-07 Bmall Bwstem 

#LOGINB 

*EXIT 

Readw 



IXC** BiUILD Complete *** 
Ready 

RUN * BUILD 

BUILD V7»0-07 RBTB V7,0--07 Small Bwstem 

Bystemi Build <No:> ? NO 

Source Input Device <SYJ:> ? DKOJ 
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Librarw Output Devic© <SYJ> ? SYJ 
Target Swsteiri Device <SYO:> ? SYO? 
Library Account <JLlt2T> ? Cly23 
Control File is ? SPLER 

*** Copvjin.<=f file DKOtCl !'23SPLER»CTL to BLnOiUTMP *** 

Function (Bui Id/Patch x Patch » Build) <Bui Id/Pa tch> ? BUILD 

Run-Time System <BASIC > ? BASIC 

Locate SPOOLING Package on <SY JCl »2a> ? SYJ i:i » :l:l;l.:] 

%Can't find file or account •- SYJi:iyl:UJ 
Attempt to create account SYJ CI r 111:3 <No>? YES 
Account SYJ LI r 111:3 created with your password 
Additional Control File is <None:> ? 

Ready 

ASSIGN SYOJSYSDSK 

Ready 

ASSIGN SY: SYSTEM 

Ready 

ASSIGN L"l»23 

Ready 

ASSIGN BKOt INPUT 

Ready 



!********** SPLER*CTL - SPOOLING PROGRAM BUILD 

! Copyrij^ht <C) 1979 by DifJital Ectuipment Corporation? Maynarde Mass 



SCALE 

Ready 

OLD DK0Ji:ir23aUE.BAS 

Ready 

COMPILE SY:C1»230UE <232:: 

Ready 

SCALE 

Ready 

OLD DK0{C1»2.1QUEMAN»BAS 

Ready 

COMPILE SYJClfH130UEMAN 

Ready 

SCALE 
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Readw 

OLD DK0:C1»23QUMRUN.BAS 

Readw 

COMPILIE SYttll^lllilQUHRUN 

Read«j 

SCALE 

Ready 

OLD DKO t C 1 » 2 :3 OPSIER ♦ DAB 

Readw 

COMPILE S Y t r. I » 1 1 1 :3 OPSER 

Ready 

SCALE 

Ready 

OLD DKO Xtif 2::iaPSRUN ♦ BAS 

Ready 

COMPILE SY J [: 1 r 1 1 1 30PSRUN 

Ready 

SCALE 

Ready 

OLD DK0Ji:i»2:iCHARS ♦BAS 

Ready 

COMPILE SY J t: i y J. 1 1 D CHARS 

Ready 

RUN sy:i:i»iii3Chars 

CHARS Kf7*0--07 RSTS V7*0-07 Small Syistem 
Ready 

SCALE 

Ready 

OLD DKO:i:ir23SPOOL ♦BAS 

Ready 

COMPILE SYtCI. yd. :U:3 SPOOL 

Ready 
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BCAI...L=: 

Ready 

OLD DKO t\:i9 2 ISPL 1 01... . B AS 

Readw 

coMP :i; LE s Y J c: 1 !/ 1. 1 :i. :i bpl i dl 

Readw 

SCALE- 

Readw 

OLD DKO J C 1 » 23SPLRUN ♦ BAS 

Ready 

COMPILE SY t C 1 y 1 1 1 IISPLRUN 

Readw 

SCALE 

Ready 

OLD DKO : Z 1 f 2 1 B ATDCD ♦ BAS 

Ready 

COMPILE SY i Z .1. f X 1 1 3BATDCD 

Ready 

RUN SYJi;::U111.:]BATDCD 

BATDCD V7,0--07 RSTS M7«0-07 Small System 

Ready 

SCALE 

Ready 

OLD DK0Jr:i?2:.1BATCH ♦BAS 

COMPILE SY i Z if 11 1 :3 BATCH 
Ready 

SCALE 

Ready 

OLD DKOJ CI f 2:iBATIDL»BAS 

Ready 

COMP I LE S Y t r :l f 11 .1 .1 BAT I DL 
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Re3dw 

SCALE 

Readw 

OLD DKO { C 1 f 2 :i B ATIiEC * X^ AS 

Readw 

COMPILE SY n: 1. >. :L 1 :l :i]E<ATnEC 

Readw 

SCALE 

Readw 

OLD DKO J C: 1 y 2:iBATRUN ♦ DAS 

Resdsrf 

COMF'itLE BY t [! 1 y 1 1 .1. "JBATRUN 

Resdw 



RUN byu:i»2:jf'IP»sav 
*s Y t \: :i f 2 1 SPOOL ♦ tmp====kb t 

DETACH 

LOGIN KB J i:i»2::i 

FORCE KBt RUN SYi CI y 1JJ.:iOPSER 
FORCE KBt DETACH 

LOGIN kb: i:::i!<2:j 

FORCE KBt RUN SY J III ? llliilOUEMAN 

FORCE kb: detach/priority jo 

LOGIN KBt [:i»2:3 

FORCE KBt RUN SY t i:::l. y lliUSPOOL 

FORCE KBt LP0t/HEADt2 

LOGIN KBt i:i»23 

FORCE KBt RUN SY t til y lll."JBATCH 

FORCE KB t BAO t /ERROR t F AT AL/NOQUEUE/NODELETE 

ATTACH 

*SYO t L" 1 y 21] SPOOL ♦ CMD/PR t NOWARN-==BY t L" ;l. y 2:3 SPOOL * TMP/AS 
*SY t C 1 y 2:]SP00L » TMP/DE t NOWARN 

Readw 

RUN SYU:i.y23CPATCH 

CPATCH V7»0~07 RSTS V7*0-07 Small Swstein 

File to patch •" SYOt i::i y2::iSTART,CTL 

*KBt 

* 1 0/ » ©SPOOL ♦ CMD/-1 1C/G>SP00L ♦ CMD/EX 

Patch 'from .„KBt CI y2:i ♦CMD cairiPlete* 

*"Z 

File to r-atch - '^Z 

Readw 

RUN SYti:iy2:3CPArCH 

CPATCH y7*0~07 RSTS V7«0-07 Stnall Swivtem 

File to patch •" SYOt CI y2:3CRASH»CTL 
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■•1KB J 

* JG/ i ©SPOai. ♦ CMD/~1 IC/eSPOOL . CMIi/EX 

Patch from .„KB: C:l »2:i fCMD complete 4 

File to patch ••- "'7. 

Ready 



!*** BUILD Complete *** 
Re<i»dw 



RUN *UTILTY 

UTILTY K}7*0-07 RBT£) V7»<)-07 Small Swistem 

♦inSMOUNT DKO: 

#"Z 

Ready 

MOUNT DK0JSYSL2G/R0 

Ready 

RUN *BUILD 

BUILD V7«0- 07 RSTS V7»0~07 Small System 

System Build <No> ? NO 

Source Input Device <SY*> ? DKOt 

Library Output Device <SYt> ? SY: 

Tarj^et System Device <SYOt> ? SYOt 

Library Account <ll:ly2;L> ? CI r 211 

Control F'ile is ? BIGPRG 

*** Copyin<-J file DKO J CI i.2:.1BIGPRG»CTL to BLDO.t»TMP *** 

Function (Build/Patchi- Patchy Build) <Build/Patch> ? BUILD 
Run-Time System <BASIC > ? BASIC 
Additional Control File is <None> ? BACKUP 

*** Copyinsl file DKOJ CI »23BACKUP*CTL to BLDOl^THP *** 

Locate BACKUP Packasie on <SYJC:lr2.T> ? SYJC1»563 

%Can't find file or account -- SY 1 11 r '361 
Attempt to create account BY t\:if '561 <No>? YES 
A c c o u n t S Y ♦ C .1. r'56'.'i c r e a t e d w i t ^l your p a s s w o r d 
Additional Control File is <None> ? DEVTST 

*** Copyin£{ file DKO JCl y2„1DEVTST.CTL to BLDOltTMP *** 

Locate DEVTST Packasje on <SYtCly2:J> ? SY:Clyll73 

DiCan't find file or account - SYJC1.yll7.T 
Attempt to create account SYJ CI y :l:l7:3 <No>? YES 
Account SYJClyll7:i created with your password 
Additional Control File is <None> ? 

Ready 

ASSIGN SYO:SYSDSK 
Ready 



E-46 System Generation Examples 



ASSIGN SY J SYSTEM 

ASSIGN l:u2::i 

pileadw 

ASSIGN DKO: INPUT 

Ready 



! )K**)K*>l<**>!oK BIGPRG«CTL - LARGE PROGRAM BUILD 

! CopwriiiJht (C) :1979 bw Bif-iitBl EauiPinent Co r^o ration!' Ma wnardy Mass 



SCALE 

Readw 

OLD DKO t r: J. y 2 :3 D I SPL Y ♦ B AS 

Readw 

APPEND DKOa::!. y2:iUT05 »DPY 

ReadH 

COMPILE SY t r; :l. i- 2:IMT5DPY<232;: 

Readw 

SCALE 
Readw 

OLD DKO : i:: :i. ^ 2 :j d i spl y ♦ b as 

Roadw 

APPEND DK0Ji:iy2::iMT50 ^DPY 

Ready 

COMP I LE S Y : r: :l. v 2. 3 'v'TI^OI-' Y<232:: 

Ready 

SCALE 

Ready 

OLD DK0JLlf2:iFIT»BAS 

Ready 

COMPILE SY J tl i'2:iFIT<2;X2> 

Ready 

SCALE 
Ready 
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OLD DKO tllf2 :iF L INT ♦ »AS 

Ready 

COMP I LE S Y J C :l r 2 :i FL I NT<40> 

Ready 

SCALE 

Ready 

OLD DKO J C 1 y 23PMDUMP ♦ BAS 

Ready 

COMPILE £5Y : i; 1 y 23PMDUMP<40> 

Ready 

SCALE 

Ready 

OLD DKO : C 1 T 2:JBPCREF ♦ BAS 

Ready 

COMP I LE S Y J C 1 y 2 3 BPCREF<40> 

Ready 

SCALE 

Ready 

OLD DK0Jt:i»23BPCRFl»BAS 

Ready 

COMP I LE S Y t C 1 » 2 3 BPCRF 1 <40> 

Ready 

SCALE 

Ready 

OLD DKO:ri y2:]RUN0FF*BAS 

Ready 

COMPILE BY J C 1 y 23RUN0FF<40> 

Ready 

SCALE 

Ready 

OLD DK0JCl»2:iMAKSIL»BAS 

Ready 
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COHPILE SY : Z 1 y 2:iMAKeiL 
Readw 



RUM SY:t:.i, »2np:[p.SAM 

>KS Y ? i:; 1 c 2 :i s a vres ♦ ba v< i 2'4>/rt s : rt 1 1 "^'DKo u: i » 2 :3 ba vreb ♦ ba v 

Ready 



RUN BY:L"ly2:iP.TP»BAV 

*SY X L 1 y 23BPCREF ♦ HI...P<40>'«riK0 : 1 1 v 2:.1BPCREF- ♦ Hl„P/AB/NO 

*S Y J i: 1 » 2 :i F X T . HLP<40>:=-»K0 X 1 1 9 2 1 f 1 T ♦ HLP/ AB/ND 

>KSY X Z 1 V 2:3RUNC)FF * RN0<40>™liK0 J t X y 2:]RUN0FF ♦ RNO/AB/NO 

Ready 



! )J<>K)i<>{<>toK>|c*>lc>K BACKUP ♦CTL •-• BACKUP PROGRAM BUILD 

! Copyri.<.-{ht <C) 1979 bw Dii-Jital EauipiTient Corporation y Maynardy Mass* 



BCALE 

Ready 

OLD DKO : C: 1 y 2 3 BACKUP * BAB 

Ready 

COMPILE SY J t: :l y 5A:3BACKUP<232:: 

Ready 

SCALE 

Ready 

OLD DKO 1 1:: :l y 2 1 B ACLST ♦ BAB 

Ready 

COMPILE BY X 1;: :l y S<!i::iBACLBT<232:: 

Ready 

SCALE 

Ready 

OLD DKO J 1: 1 y 2 :i BACCON ♦ BAB 

Ready 

COMPILE BY J t; :l. y SA:3BACC0N<232:: 

Readv-j 

SCALE 
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Resdw 

C)Li;i DKO J t: 1 » 2::iBACDlR ♦ BAS 

Readw 

COMP I LE S Y ill, 56 3 B ACD I R<232> 

Resdw 

SCALE 

Ready 

OLD DKO J t: :l. f 2 :.l BACMNT ♦ B AS 

Readw 

COHPXLE SYJi:ir56:iBACMNT<2:32> 

Ready 

SCALE 

Ready 

OLD DKO } C 1 f 2:]BACLAB ♦ BAS 

Ready 

COMPILE 3Y : C 1 y 56 :iBACLAB<232> 

Ready 

SCALE 

Ready 

OLD DKO t C 1 » 2:JBACDSK » BAS 

Ready 

COMPILE SY:i:if5A3BACDSK<232> 

Ready 

SCALE 

Ready 

OLD DKO tlif 2:3BACKTO » BAS 

Ready 

COMPILE SYJ C:L r56nBACKT0<232> 

Ready 

SCALE 

Ready 

OLD DK0Ji:ir23BACC0M,BAS 
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COMPILE SY 1 1 1 »S6:iBACC0M<232> 
Readw 

scale: 

Readw 

OLD DKO n: ;l y 2:iBAC]CiMP ♦ BAS 
Resdw 

C(3MP:nJE BYJ i:::l, >'561BACDMP<2;32> 
Re^••>dw 

SCALE 
Readw 

OLD »K i i:; 1i.r21 B ACBEL ♦ B AS 
Ready 

COMPILE SYU::L l'563BACDEL<232> 
Re«}dw 

SCALE 

Readw 

OLD DKO 1 1:: 1 1 2 1 B ACLOD * BAS 

Readw 

COMP I LE S Y tllf'56 1 B ACL0D<232:: 

Ready 

SCALE 

Readw 

OLD DKO J r 1 » 2:]BACENT » BAS 

Ready 

COMPILE BY J t: :l. r 5A3BACENT 

Ready 

SCALE 

Ready 

OLD DKO U: 1 y 2 3 B ACFRM * BAS 

Ready 
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COMPILE SY: C:.1. rS6.^1ElACFRM<232> 
Reaclu 

SCALE 

Resdy 

OLD DKO 1 1: 1 f 2-1BACPRM ♦ BAB 

Ready 

COMPILE SYJClySAJBACPRM 

Ready 

RUN J3YJC:U5<(i:iBACPRM 

BACPRM V7»0-07 RSTS V7 ,0-07 Small System 

Ready 



I********** DEVTST4CTL •■" DEVICE EXERCISER PR0(3RAMS 

! Copyright (C) 1979 bw i:i:L«{:LtaI Ewuir-ment Corporation y Maynardy Mass* 



SCALE 
Ready 

OLD DK0:i:i»2nDSKSEK»BAS 

Ready 

COMPILE SY XLlr 1 17:;iDSKSEK 

Ready 

SCALE 
Ready 

•OLD DK0Ji::Lr23DSKEXR.BAS 
Ready 

COMPILE SY ti:: 1 f 1 17:iDSKEXR 
Ready 

SCALE 

Ready 

OLD DK0Ji:i»2DLPEXER»BAS 

Ready 

COMP I LE S Y J [; 1 » 1 1 7 .1 LPEXER 

Ready 

SCALE 
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OLD DKO : i: 1 y 2 :i PPEXE R » BAB 

coMP :i: LE s Y 1 1: i ^ :i 1 7 :;i ppexer 

Readbi 

SCALE 
Ready 

OLD DKO : i:: :i. » 2 iiprexer » bas 

Readw 

COMP :i: LE BY : i:: :i. r 1. 1 7 ::i prexer 

Ready 

BCALE 

Ready 

OLD DKO 1 1:: 1 y 2 :\ DXEXER ♦ BAB 

Ready 

COMPILE BY X 1 1 y 1 1 7 ::i DXEXER 

Ready 

BCALE 
Ready 

OLD DKO t \: 1 9 2 :;i dtexer ♦ b ab 

Ready 

COMP I LE BY 1 1:; 1 9 117 ::i dtexer;; 

Ready 

! ERRORB W:i:LL REBULT when the CPEXER PROGRAM IB BUILT 

! UBING CSPCOM OR BABIC PLUB IF THE NECESSARY MATH OPTIONS 

! WERE NOT SELECTED* 

SCALE 

Ready 

OLD DKO J i: :l » 2 :j cpexer ♦ b as 

Ready 

COMP I LE BY 1 1:: :i. y 1 1 7 ::i cpexer 

Ready 
SCALE 
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OLD DKO : t; 1. r 2 J CPUTST . BAS 

COMPILE SY J [: .1. f 1 17:k:putst 

Ready 

SCALE 

Readvj 

OLD DKO J i: 1 r 2 :IKBEXER ♦ BAS 

Ready 

COMP I LE SY tt:itiX 1 :i KBEXER 

Ready 

SCALE 

Ready 

OLD DKO : CI f 23MTEXER . DAS 

Ready 

COMPILE SY \tli 1 .1.73MTEXER 

Ready 



!*** BUILD Complete *** 

Ready 

RUN *PIP 
*$NOTICE.TXT 

WELCOME TO RSTS/E V? ^Q TIME SHARING 



#SYJ$NOTICE»TXT=KBJ 

WHAT A WAY TO START YOUR DAYRSTS/E-^Z 
*SYt*NOTICE»TXT='=KB: 



WHAT A WAY TO START YOUR DAY RSTS/E V7*0!!! 
*$HELP»TXT 

TO OET ON-LINE AND USE RSTS/E r FOLLOW THE 
INSTRUCTIONS FOUND IN THE 
RSTS/E SYSTEM USER'S GUIDE* 
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*$HELFMXT"KBt 



SEE ANDY IF YOU NEED A PRIVILEGED ACCOUNT NUMBER 

*$START«CTL 
(?BY0?i::li'2;jRTS.CM» 

(»<3YOJi:if2:rrTY»CMri 

©SPOOL ♦CMDCly 23 

9.B^ot\:i*2:\ccL*cm 

DETACH 

LOO IN KBOJ r;j. y2:j 

FORCE KBOI RUN SY: t!! y23UTILTY 

FORCE KBOJ REMOVE LOGICAL LB 

FORCE KBOJ ADD LOOICAL SYU:3. y200;]LB 

FORCE KBO: EXIT 

FORCE KBO: BYE/F 

ATTACH 

FOF^'CE KBOJ RUN SY t CI r273ERRINT 

FORCE KBOJ .1.00 

FORCE KBOJ NO 

LOGINS 

SEND RSTB/E IS NOW ON THE AIR»»» 

END 

*$CRASH*CTL 

(?SY0JI.':.ty2:iRT8»CMD 

(»SY0Ji:iy2::iANALYS»CMD 

(»SY0JL"ly2:;iCLEAN»CMD 

(?SY0Ji:iy2::iTTY»CMD 

espooL»CMDi::i^2J 

C')SY0JC:ly2:iCCL»CMB 
DETACH 

LOGIN KBOJ i:::i. y2:j 

FORCE KBOJ RUN BY J i::.l y 23UTILTY 

FORCE KBOJ REMOVE LOOICAL LB 

FORCE KBOJ ADD LOGICAL SY J tM y 208.1LB 

FORCE KBOJ EXIT 

FORCE KBOJ RUN SY J 1 1 y2::iaUE 

FORCE KBOJ BY J CM y27:]ANALYS»DMP/DE 

FORCE KBOJ EXIT 

FORCE KBOJ BYE/F 

ATTACH 

FORCE KBOJ RUN BY J El y27.1ERRINT 

FORCE KBOJ 100 

FORCE KBOJ YEB 

LOGINS 

SEND RBTB/E IS NOW ON THE AIR»»» 

END 

*SY J *ACCT * SYB<iee>"-==KB J 

2 y 4 y CLASBE y y y EDUCATION CLASS 

4 y 16 y LBRACC y y y L IBRAR Y ACCOUNT 

16 y 256 y ROGER y y y SECURITY ACCOUNT 

8 y 128 V YUSEIT y y y GENERAL ACCOUNT 

"Z 

Re«dw 

RUN $REACT 

REACT V7*0"07 RSTS V7«0-07 BiTiall Syfrtem 

System Account Manaf^er 

Function? STANDARD 

All Accounts In Account File are now Entered 

Function? '"Z 

Readw 
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RUN *BHUTUP 

QHUTUP ^7*0 "07 RSTS V7»0-07 Small Swstein 

10:24 PM 22~Apr-"79 ******** Set-up X\iBlo;-iu(s Phaae ******** 

Type 'ESC ( 'ALT' ) to any auery to backup one CI.) step 

'OPSER' not runnin.^ 

Minutes until system shutdown (0-99) <5>? 

10 J 24 PM 22--Apr-79 ******** Warnini^ Messaide Phase ******** 
Further LOGINs are now disabled 

10:24 PM 22-Apr""79 ******** Initial Job Killin<;J Phase ******** 

10:24 PM 22-"Apr 79 ******** Remove RTS/RES LIB Phase **##**#* 

10:25 PM 22-Apr™79 ******** SWAP F"ile Removal Phase ******** 

10:25 PM 22~Apr-79 ******** Disk DISMOUNT Phase ******** 

10:25 PM 22--Apr--79 ******** Final Shutdown Phase ******** 

Please wait for system to re-boot itself 



RSTS V7»0-07 Small System (DBO) 

Option: SAVRES 

22~Apr~79? 

Enter date as 'DAY-MONTH -YEAR' <e»^w 31-DEC-76) 

or as 'YEAR* MONTH ♦DAY' <&*<A.f 76 ♦12* 31) ? 22 -APR -79 

10:26 PM? 

Enter time as 'HOUR: MINUTES AM' or 'HOUR: MINUTES PM' (etf.3* i:i5 PM) 

or in 24-hour format as 'HOUR: MINUTES' (e»<-i* 13: 15) ? 10:26PH 

SAV/RES Function: 

Please enter one of the valid SAV/RES functions c 
or type 'HELP' for a help messai^e: HELP 

The valid SAM/RES functions are: 

SaOe Make a safe copy of a RSTS/E file-structured disk* 
RESTORE Restore a RSTS/E file-structured disk from a SAVE Set* 
IMAGE Copy a volume ima^e from a RSTS/E file-structured disk 

to a LIKE disk* 
IDENTIFY List the characteristics of a SAME Set or RSTS/E disk. 
HELP Print this list of acceptable responses* 

Only the first two characters need be typed* 

SAV/RES Function: IDENTIFY 
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F"roiTi Device? * 

Twpe 2 characters to specify the input device twpey 
followed bw a siru^le disiit <0-7) to specif w the unit 

Include a Save Set name or Pack ID if wou want SAVRES 
to ensure it matches the one on the volume* This drive 
should be WRITE-LOCKED* 

From Device? DKO 

Device? DKO J 

Pack id: SAMPI...3 

P <•> c k C' 1 1..I s t e r i:> i z e * 2 

C) r e B t i o ri d a t e * S u n d a w y 2 2 - A p r 7 9 



SAM/RES Function! SAk/E 
From R8TB disk? 

Twpe 2 characters to specify the input device tapes' 

followed by a sinjJle di;^it (0-7> to specify the unit 

number* 

Include a Pack Id if you want BAVREB to ensure it 

matches the one on the volume* This drive should be 

WRITE -LOCKED* 

From RBTB disk? DBOJ 

**>!{ Pack ID/default Save Set Name is SM 1.^^70 

I 
To Device? 

Type 2 characters to specify the output device twpe» 

followed by a sin;-Jle di.<j1it (0-7) to specify the unit 

number* 

Include a Save Set Name if you wish to override the 

default* This drive should have a SCRATCH volume 

mounted)' and must be WRITE-ENABLED* 

To Device? DKOJRECMED 

>!<** The volume on DKO? is a RSTS disk 
>loK)!< Pack :i:D is SAMPL3 

*>|oK Pack will be reinitialised 

Mount it anyway <N0>? 

^t^ This is your last chance to prevent the 

>!oK* loss of any data on the output volume 

Mount it anyway <N0>? YES 

*** Save Set Name is RECMED 

Exp i rat i on Date <2 :l. -• Ap r • -SO:::? 

Type the desired expiration date or press t\m LINE FEED 
key to accept the date printed* 

Expiration Date <2:L-Apr-eO>? 2:1. •■•APR--82 

Verify (Yes or No) <N0>? 

Type 'Yes' if you want SAMRES to compare the input and 
output volumes at the end of each output volume* 
Type 'No' or press the LINE FEED key if you do not want 
SAVRES to perform this verification* 
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Vt^rifw (Ye<3 or No) <N0>? YES 

Proceed (Yes or No)? 

Twpe 'Yes' to proceed with the operation* 

T^dpe 'No' to abort <-ind return to the BAV/F^ES Function * prompt* 

Proceed (Yes or No)? YES 

*** .Initial izinsi first SAVE volume 

*** Be.^in SAME from DBOJ to DKOt at ;I.0J;?7 PM 

*** Beslin VERIFY pass from DBOJ to DKOJ at .tO:3B PM 

*** differences found 

Dismount Device? DKOJ 

Set Name? RECMED 

Sea *♦ 1 

Creation date: Sunday* 22"Apr"79 

Expiration date* Wednesday > 2.1.-Apr-e2 

Please label this volume! 

Mount volume * 2 of SAVE Set RECMED 
Device ? 

Twpe 2 characters to specify the output device typer 

followed by a sin.«ifle di*^it (0-7) to specify the unit 

number* 

This drive should be WRITE -ENABLED* 

Mount volume * 2 of SAVE Set RECMED 
Device ? DKlt 

*** The volume on DKlt is a RSTS disk. 
*** Pack ID is SAMPL4 

*** Pack will be reinitialized 

Mount it anyway <N0>? 

*** This is your last chance to prevent the 

*** loss of any data on the output volume 

Mount it anyway <N0>? YES 

Proceed (Yes or No)? 

Type 'Yes' to proceed with the operation* 

Type 'No' to abort and return to the mount prompt* 

Proceed (Yes or No)? YES 

*** Bed in SAVE from DBOJ to DKlt at 10 MO PM 

*** Be«{in VERIFY pass from DBOJ to DKlt at 10t41 PM 

*** differences found 

D i smoun t De v i ce J DK 1 J 

Set Name J RECMED 

Sea * J 2 

Creation date J Sunday y 22-Apr~79 

Expiration date J Wednesday y 21""Apr-"B2 

Please label this volume! 
SAVE operation completed at 10t42 PM 
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S u in in «f r w Report 
SAVEE of DB0tSHLV70 to Save Set RECMED 

triput Device t DBOt 

F'ack ;[K:iJ SMLV70 

Pack c:i.uir>ter<i>:i.x::eJ 8 

Creation date J Sundawf 22-"Apr""79 

Output Device* Disk 

Set Name J RECMED 

# of volumes* 2 

Creation date? Sunday i* 22-Apr-"79 

Expiration date J Wednesday y 21 -Apt 82 

SAVE started on Sunday i- 22-Apr-79i' at 10 J 37 PM 

Run Statistics 

Transfer Totals? 

Total of 8928 blocks transferred 
Error Totals* 

Total of bad compares* 

Total of new bad blocks encountered on source* 
Total of new bad blocks encountered on destination* 

Timin?^ Totals? 

Total elapsed time? hrs*» 4 mins*? 5f5 sees* 
Total wait time? hrs*)- 1 mins** 31 sees* 
Total process time I hrs*!- 3 mins*f 24 sees* 

SAV/RES Function! 

Option? START 

You currently have? JOB MAX •■='■■ 20? SWAP MAX == 28K* 

JOB MAX or SWAP MAX chani^^es? NO 

Any memory allocation chanj^es? NO 

You currently have crash dump enabled* 

Crash dump? YES 

22--Apr™79? 
11? 36 PM? 

INIT '^7 » 0-07 RSTS V7*0""07 Small System 

Command File Name? 
DETACHING* * * 



HELLO 1/2 

Password? 

Job 1 is detached under this account 

Job number to attach to? 

1 other user is losJj^ed in under this account 
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Resdw 

RUN *UTILTY 

UTILTY V7.0-07 RSTS V7»0-07 Smsll System 

♦ADD SWAPFILE t SWAPO 

♦ADD RTll 

♦ADD TECO 

♦EXIT 

Readw 

BYE/F 



ATTACHING TO JOB 1 
DETACHING* ♦♦ 



"C 

HELLO :l./2 

Password J 

Job 1 is detached under this account 

Job number to attach to? 

1 other user is Io<;i<.4ed in under this account 



Ready 

RUN $TTYSET 

TTYSET V7.0-07 RSTS V7,0-07 Small System 

Terminal characteristics prorjram 

? EXIT 

Ready 
BYE/F 



ATTACHING TO JOB .1 
DETACHING, ♦♦ 



E-60 System Generation Examples 



HELLO 1/2 

Password* 

Job 1 is detached under this account 

Job number to attach to? 

1 other user is lo^«3ed in under this account 



Ready 

RUN SYJdrllDOPSER 

OPSER V7.0~07 RSTS V7»0"07 Small Swstem 

'OPBER' FILES NOT FOUND - WILL INITIALIZE* 

♦DETACH 



DETACHIN3 



HELLO 1/2 

Password* 

Jobs 1 2 &rG! detached ijrtder this account 

Job number to attach to? 

2 other users ^re loiSi^ed in under this account 



Readw 

RUN BYtdi-llDQUEMAN 

ttUEMAN y7*0-07 RSTS ^7 ♦ 0-07 Small Swstem 

' QUEUE »WRK' NOT FOUND - WILL INITIALIZE 

NO QUEUE FILE FOUND •-■• WILL INITIALIZE ^ 

STARTED ATt 11136 PM ON 22-A>^r-79 

INITIALIZED 

* 

JOB *3 'QUEMAN' PUT ONLINE 

DETACH/PRIORITY JO 

DETACHING . ♦ . 



"C 

HELLO 1/2 

Password* 

Jobs 1 2 3 are detached under this account 

Job number to attach to? 

3 other users are loj-f««ed in under this account 



Readw 

RUN SYJd^llDSPOOL 

SPOOL V7*0~07 RSTS M7*0""07 Small Swstem 

#LPO : /HEAD J 2/PH Y t KB 1 4 t 

DetachinsJ* ♦ ♦ 
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HELLO 1/2 
Password* 
Jobs 12 3 
Job number 



4 Br& detschosd under this 
to attach to? 



account 



4 other users Br& loi-Jded in under this account 



Ready 



RUN SYJd^llDBATCH 

BATCH V7.0~07 RSTS V7.0-07 Small System 

JOB *4 'LPOSPL' PUT ONLINE 

MESSAGE 1 J 22-AF'r-79 li:37 PM JOB 1 3 DET 

LPOSPL (4) PUT ONLINE 
#BAO J /ERROR : PATAL/NOOUEUE/NODELETE 
DETACHING, ♦♦ 



QUMRUN Ills' 2:1 



ATTACHING TO JOB 1 
DETACHING. ♦♦ 



HELLO 1/2 

Password* 

Jobs 1 2 3 4 S are detached under this account 

Job number to attach to? 

5 other users Br& lo^sJed in under this account 



Ready 



JOB *5 'BAOSPL' PUT ONLINE 



MESSAGE 

RUN (1»2 
UTILTY 
♦CCL ATT 
*CCL ATP 
*CCL BCK 
♦CCL BPC 
*CCL BYE 
*CCL CNV 
*CCL CRE 
*CCL DEF 
#CCL DFN 
*CCL DES 
*CCL DIS 
♦CCL DI- 
♦CCL DSP 
♦CCL EDT 
♦CCL ED~ 



BAOSPL 

)UTILTY 

V7*0-07 

ACH-=<1 

K== < 1 » 2 

= ( 1 y 2 ) 

REF==(1 

= < 1 » 2 ) 

= (11-2) 

ATE=<1 

-•==(1)'2) 

~ ( 1 y 2 ) 

-"== ( 1 y 2 ) 

-MOUNT'--'! 

RECTORY 

-=<ly2) 

-=(ly2) 

ir==<lr2 



(5) PUT ONI., 



-Apr- 
INE 



79 11J37 PM JOB J 3 DET 



aUMRUNIll 



RSTS ^7*0-07 Small System 
y2)L0GIN,*JPRIV 30000 
)ATPK.*?PRIV 30000 
RMSBCK.TSKrO 
y2)BPCREF.*J30000 
LOGOUT,*; PR IV 
RMSCNV,TSK?0 
»2)EDIT,>KJ30000 
RMSDEF.TSKJO 
RMSDFN,TSKJO 
RMSDES.TSKJO 
< 1 y 2 ) UMOUNT ♦ * J PR I V 30000 
= ( 1 y 2 ) DIRECT * * y PRI V 30000 
RMSDSP,TSKyO 
EDT,TSK?0 
)EDIT,*y 30000 
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♦CCL F;i:T--:^(:Lf2)Fa:T*>K?PRIU 30000 
*CCL HIELL0--=--<ly2)LGG;iN*>K?PR'IV 
*CCL IFL--" < 1 y 2 ) F^'MSIFL « TBK ? 

♦ CCL l..,BF\'~=^= (11-2) LBR ♦ TSK f 
♦CCL LIB-R::':< .1. !-2)L.TBF^SAM?8208 
♦CCL L.TN-K--"< 1 y2)L.lNKiSAV?8208 

♦ CCL LOG ••• I H-~ ( .1. V 2 ) LOG IN** 5 PR I V 

♦ C C, I... M A C R •- ■■■■" < .1. K 2 ) M A C R ♦ S A M y 8 2 .1. 6 
♦CCL MAC ••••" < :l y 2 ) MAC ♦ TSK ? 

♦ CCL MAK-"K;>'; < ;(. y 2 ) TE CO ♦ TEC y 

♦ CCL MOU-N r=- ( :l. y 2 ) UMOIJNT * * y PR .i; V 30000 
♦CCL MU~NG™ ( .1. y 2 ) TECO » TEC y 

♦ CCL PAT-:^:: < 1 9 2 ) PAT « TBK i 

♦ CCL PIP-::: ( .t y 2 ) PXP ♦ SAM ? 8208 

♦ CCL PL-EASE::-'^ ( ;l y 2 ) PLEASE ♦ * y PR .T M 30000 
♦CCL QU- "EUE:::: < 1 y 2 ) QUE * * ? PR I U 30000 

♦ CCL RST™-::-- < .1. y 2 ) RMSRST ♦ TSK ? PRIM 
♦CCL SE ■-T:-= ( ;l. y 2 ) TT YSET * * y PR I M 30000 
♦CCL SRT™:::: ( J. y 2 ) SORT « TSK ? 

♦CCL S IJ-BM I T::-: < .1 y 2 ) QUE . * P PR I V 30000 

♦ CCL SW-XTCH:::: ( .1 y 2 ) SWITCH » * ? PRI V 30000 

♦ CCL SY-STAT-:(.ty2)SYSTAT,*yPRIV 30000 

♦ CCL TE-CO^:: ( :l. y 2 ) TECO ♦ TEC y 
♦CCL TKB-:::: ( 1 9 2 ) TKB ♦ TSK y 
♦CCL TY-PE:::: ( il y 2 ) TECO ♦ TEC J 8 

♦ CCL UT-ILTY:-:: < :L y 2 ) UTILTY , * y 30000 

♦ EXIT 

Ready 
BYE/F 



ATTACHING TO JOB :(. 
BET ACHING, .♦ 



"C 

HELLO 1/2 

Password t 

Jobs :l. 2 3 4 5 are detached under this account 

Job I'l umber to atta<?h to? 

5 other users Bre losSsSed in under this account 



Ready 

RUN SY? (ly2)UTILTY 

UTILTY M7,0"-07 RSTS V7,0"07 Small System 

♦REMOVE LOGICAL LB 

♦ ADB LOG I C AL S Y J < .1. y 208 ) LB 

♦EXIT 
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Resclw 
BYE/F 



ATTACHING TO JOB 1 
RUN SY:(1»27>ERRINT 
100 
NO 

Resdy 

ERRINT ^7*0-07 RSTS V7.0--07 SmailJ. System 

ERRLOO Fil& is 2% Full 

ChsnsJe Size to < 100 >? 

Utilxsre Crash File Outj^ut < Yes/No) <No>? 

Detaching ♦ ♦ . 



HELLO 

RSTS V7»0~07 Small System Job 6 KBO 22-Ar'r™79 11J:59 PM 

♦ It 2 

Password ♦ 

Jobs 1 2 3 4 5 are detached under this account 

Job number to attach to? 

5 other users &r& losii-ied in under this account 



WHAT A WAY TO START YOUR DAY RSTS/E V7«0!!! 



Ready 

RUN fSHUTUP 

SHUTUP V7,0-07 RSTS V7.0--07 Small System 

11 J 39 PM 22-Apr~79 #******* Set -up Dialoi^ue Phase #*##*#f # 

Type 'ESC ('ALT") to any «uery to backup one <1) step 

Use 'OPSER' for utilities shutdown (YES/NO) <YES> YES 

Allow utilities to reach lo«Jical end point (YES/NO) <YES>? YES 

Minutes until system shutdown <0--99) <5>? 

11 MO PM 22--Apr-79 *#*###*# Warninsl Messai^e Phase ########• 
Further LOGINs are now disabled 

11 MO PM 22~Apr-79 #*###*#* Initial Job Killin<-{ Phase *##*###* 

IIMO PM 22-Apr~79 **###*** ' OPSER ' Shutdown Phase ***=il=#### 
DetachinjS* ♦ ♦ 
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'OF'SEFr ATTACHING 

* 

JOB *'5 'BAOSPL' TAKEN OFFLJNF 

MESSAGE 3 t 22--fi,f->v-79 11 MO PM JOB J 3 BET 

BAOSPL (5) REOUESTEB OFF-LINE TAKEN OFF-LINE 

■# 

JOB #4 'LPOSPL' TAKEN OFFLINE 
* 

MESSAGE 4 | 22"-Apr"79 11 MO PM JOB J 3 BET 

LPOSPL <4) REQUESTEB OFF-LINE — TAKEN OFF-LINE 

JOB *3 'OUEMAN' TAKEN OFFLINF 
♦"OPSER" TERMINATING 



auMRUNi;:iy2;3 



QUMRUNi:i!-2;] 



Re-attach And* ♦ ♦ 

11 MO PM 22-Apr™79 #f#:||.#### ' ERRCPY ' Shutdown Phasie **#*#*** 

11 MO PM 22~AP'r""79 ###f#|:*# Remove RTS/RES LIB Phase ****#**#• 

11 MO PM 22™Apr-79 #*###*#:|: SWAP File Removal Phase **•#*#### 

11 MO PM 22-Apr-79 #*####*# Bisk BISMOUNT Phase *#.H:*## ## 

11 MO PM 22-Apr~79 ###.##### Final Shutdown Phase #*###### 
Please wait for system to re-hoot itself 



RSTS V7»0™07 Small System <BBO) 



Option* 
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System Generation Example — Large System Configuration 



EriciblinsJ only consalei* disks* and tapes* 

Warnin*^ ** DB2t is dual fortedr proceed with caution! 

W a r* n i ri <:i * * D l£i :l. ♦ i s d u a 1 p o r t e d ? p y' o c e e d w i t h c a u t i o n ! 

RSTS M7>0 (DMl) 



Option* 

Please enter one of the valid RSTB/E svjstem initialization 

options? or twpe 'HELP' for a help inessasJe* HELP 

The valid RBTS initialization options a re J 

BSKINT Initialize disk to RBTB file structure 

COPY Copy minimal s*:*stem to disk 

PATCH Patch a file 

H A R D W R S e t c o n t r o 1 1 e r' c h a r a c t e r> i s t i c s 

INSTALL Install a monitor BIL 

REFRESH Manipulate files in COylll 

D i;;: P a U L T B e l-, in o n i t o r' d e f a u 1 1 s 

SET Set device characteristics 

S T A R 1" S t <i> r' t t i in e s h a r :i. n <■! 

<LF> Start timesharing^ (fast) , 

BOOT Bootstrap a device 

LOAD Load a stand-alone proi'iram 

UNISYS Disable all but console terminal 

FILL Set console fill for INIT 

SAMRES SAVE or RESTORE a RSTS/E disk 

HELP Twpe this HELP messa<^Je 
n 1 w t h e f i r> s t t w o c h «> r b c t e r s ri e e d b e t 'r.t p e d ♦ 

Option? DSKINT 

22-Ap» 79? 

Enter date as 'DAY-MONTH-YEAR' <e ♦««»!. 31-DEC-76) 

or as 'YEAR* MONTH* DAY' (e*s{*» 76*12*3:1.) ? 22 -APR -79 

04:39 PM? 

Enter time as 'HOUR t MINUTES AM' or 'HOUR J MINUTES PM' (e*<^* lil'5 PM) 

or in 24 -hour format as 'HOUR? MINUTES' < e * <=J ♦ J,3t:1.5) ? 4 J 39 PM 

Disk? 

D i s k t \:{ p e ( D C y D I-' f D S c D K y D I... j D M c D I-' y D B r D R ) ? D l^^: 

Unit? 

Physical unit number (0-7)? 

Pack ID? 

Up to 6 alphanumeric characters? BI0V70 

P a c k c 1 u s t e r b i z e ? 

4? By or 16? B 

SATT*BYS base? 

Twpe a block number to locate the file SATT*BYS at a specific 

Place on the disky or twpe <LF> to let RSTS find a location* 

8ATT*BYS base? 20000 

MFD password? 

Up to 6 alphanumeric characters? SECRET 

MFD cluster size? 
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& or 16? B 

Pre-extend directories <rio>? 

Type YES to force the MFD and accounts COrlH and ClySH 

be r-- re-extended to their inaximum size when created* 

Pre-extend directories <no>? YES 

PUBy PRIr or SYS? 

Public (PUB)t private <PRI)» or system (SYS) disk? BYS 

Library password? 

Up to 6 alphanumeric characters? HIDDEN 

Librarvj UFD cluster size? 

B or 16? 16 

Library account base? 

Type a block number to locate the the library account at a specific 

place on the disky or type <LF> to let RSTS find a location* 

Library account base? 20000 

Date last modified <yes>? 

Type 'YES' to maintain date of last modification in the 

directory on this disk* 

Type 'NO' to maintain the date of last access* 

Should this disk retain last -modified information? YES 

New files first < n o > ? 

Type 'YES' to force new directory entries to be 

added to the front of the directory* 

Type 'NO' to force new entries to be added to 

the end* 

Should directory entries be added to the front? NO 

Format <no>? 

Should the pack be formatted (Y or N)? NO 

r-'atterns? S 

Proceed <Y or N)? 

Type 'Y' to proceed with DSKlNTs- 'N' to abort it? Y 

Disk pack serial * 13A1A 



Pattern # 8 
l""attern # 7 
Pattern # 6 
Pattern f 5 
Pattern # 4 
Pattern # 3 
Pattern # 2 
Pattern * 1 

Opt ion J COPY 

22-Apr 79? 

Enter date as 'DAY-MONTH-YEAR' <e*<=«*!- 31--DEC-76) 

or as 'YEAR* MONTH* DAY' ( e * <■< * y 76*:l.2*31) ? 22-APR-79 

05137 PM? 

Ente r t i me as ' HOUR J M 1 NOTES AM ' o r ' l-IOUR : M 1 NOTES PM ' ( e * ^ * 1 Jl 5 PM ) 

or in 24"hour format as ' HOUR J MINUTES ' (e*<:J* 13? IS) ? 05:37PM 

To which disk? 

Type the name of the disk which is to receive the RSTS/E system* 

1 h e d i s k in i..i s t a I v e a d y b e i i-i :i. t i a ;i. i z e d * 

Valid disk names are DFv BSv DKs- DLy DMc DP? DDy Bnd DR* 

To which disk? DR 

Unit? 

1"' h -r;* <•> i c: B 1 I..I I"! i t n I..I m b e r ( - 7 ) ? 

E n ;ii b 1 ;i. ri .<•{ o I'l 1 y c o ri i-; o 1 e » d i s k s y <•> ri d t b p e s * 

W a r^ n i ri <;i ^t D B 2 1 i s d u b 1 p o r t e d ? p r o c e e d w i t h c b u t i o n ! 

W a r' I'l i n ai * )K D B .1. t i s d u a I p o r t e d v p r o c e e d w i t h c a i,.i t :i. o n ! 



E-68 System Generation Examples 



RSTS V7*0 <DRO) 

Option: HARDWR 

H A R D W R s I..I b o p t i o n ? 

Valid HARDWR subopfcions aret 

L 1ST I... i i!> t h a r d w a t' b a o n f i si u r a t i o n 

D I B A B I... E » i ii> B b 1 e a c o n t r* o 1 1 e r' 

E NAB 1... E E ri a b 1 e a d i s a b .1 e d c:.' o n t r* o 1 1 o r 

C S R E n t e r n o i "i •■•• s t a n d a t' d c o n t t' c> ;I. :I. e r a d d r^ e s iii 

M E C T R E I "I t e v n o n • ••• <■> t a n d a r d v e c' t o r' a d d v e i-t s 

UNITS Associate a disk t^:;pe with a control lor 

DH Set DM 1 :l. BB/BH :l. 1 assoc i at i oris 

TU5B Set TU5B/BI...:l.l associations 

HERTZ Set AC line hertz 

SWITCH .Set console switch re'^Jister characteristics 

RESET Reset all user CSR's 8i vectors? enable all devices 

EXIT (or <I...F>) Exit from HARBWR option 

Onl'j the first two characters need be twped 

HARDWR suboption? LIST 

Coininents 

BAE==':i030j Units? 0(RS04) KRS04 ID 

R \< 5 1'" u n i t s t n o ri e 

Un i t s t ( RK06 ) 1 ( RK06 ) 

BAE:===-f050y Units? 1(RP06 DP) 2<RP06 DP) 

B AE=='^-J050 9 Un i t s t ( RM03 ) :l. ( Rm)3 ) 

BAE=::f034y Units? 0<TE;L6 (!?TM02 #0) 

1(TE16 §TM02 #0) 2(TU77 (r?TH03 #;l. ) 



Name 


Address 


Vector 


TTJ 


177560 


060 


RSJ 


172040 


204 


RK t 


177400 


220 


RMJ 


177440 


210 


RBJ 


176700 


254 


RR : 


176300 


150 


TC? 


177340 


214 


TUJ 


172440 


224 


KWllL 


177546 


100 


KWllP 


172540 


104 


SR 


177570 




DR 


177570 





Hertz ■■•■-- 66. 

Other? FPU? SL? 22-Bit Addressin.<-Jy Cache w/addresss' Swstem ID 

HARDWR suboption? EXIT 

Option? INSTALL 

Sil? 

T y p e t h e f i 1 e n a m e o f t h e iri o ri i t o r s a v e i m a <;i e ;i. i b r <•> r v* * 

X!i i r e c t o r w o f a 1 1 ♦ S 1 1... f i 1 e s i n I!.' y 1 ;;i ? 

SYS0EN»S1L 

Sil? SYSGEN 

Reboot in;;.{ ♦ ♦ ♦ 

Warning's >loK DB2? is dual portedy proceed with caution! 
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Warninsl ** DBIJ is dual F'orbed» Froce^ed with caution! 
RSIS V7.0 <DRO) 

Qptian: REFRE-BH 

22"-Apr-"79? 

EnU:)r date as ' DAY-MONTH- YE AR ' <e»<^tf 3:l.-i:iEC~76) 

or as 'Y^AR* MONTH* DAY' (©♦.^♦r 76*12*31) ? 22-APR-79 

05:40 PM? 

Enter time as 'HOURtMTNUTES AM' or 'HOUR J MINUTES PM' (e».^. 11:15 PM) 

or in 24-hour format as 'HOURJMINUTES' <e.;.^» i;3J15) ? 05M0PM 

Disk? 

T wpe the name of the d i sk to refresh ( DC r HF f DS f DK y DM r DP r o v DB ) ♦ 

Type <LF> to refresh the svistem disk* 

Disk? DR 

Unit? 

Ph*:<sical unit number (0-7)? 

Clean? 

Twpe 'YEB' if wou want the disk cleaned before REFRESH in<-«* 

T i:J p e 'NO' t o <•> k i p t h e c 1 (•j a n o p e r a t i o n ♦ 

Clean? YES 

Disk is bein.*,^ t? leaned - wait ♦ ♦ ♦ 

REFRESH suboption? 

V B I i d R I;:! I"' 1-^' I::! 5:5 H s u b o p t i o I "i s a r* e t 

LIST List the file status table 

C I"! A N G I::.' C h a n <^ e t h e <■> '■..f ii> t e m f i 1 e a 1 1 o c a t i o n 

I" 1 1... I::.' C h a ri <}i e t 'n e c h <■:> r b q t e r> i s t i c s o f b f i :i. e i ri I" ? 1 "I 

DADS Examine or chan,<-5e the bad block file 

EXIT (or <LF>) to exit from REFRESH 

n 1 w t h e f i r s t t w o c h b v b c t e r s n e e d b e t «;* p e d 

REFRESH suhoption? LIST 

Current Minimum Start 
at us Size Size LBN 



CRE 64 

OK 
OK 
OK' 
OK 

OK 16 

OK 
OK 



File 






F: 


i.le 


Name 


Re 


'«ui rec 


i? f: 


Lasfs 


Swstem f- 


'ilesJ 








SWAP 


♦ SYS 


YES 






SWAPO 


*SYS 


NO 






SWAPl 


♦ SYS 


NO 






SWAP3 


* SYS 


NO 






OVR 


*SYS 


NO 






ERR 


.SYS 


NO 






BUFF 


♦ SYS 


NO 






CRASH 


♦ SYS 


NO 






Others J 










BADB 


♦ SYS 






NOD 


SATT 


♦ SYS 




NOD 


CTG 


INIT 


♦ SYS 




NOD 


CTO 


ERR 


♦ ERR 






CTG 


SYSt)EN*SlL 






CTG 


RTll 


♦ RTS 






CTG 





5 20004 

418 

16 604 

204 
20 828 
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REFRESH suboption? CHANGE 

S W A P ♦ S Y S c h B n ; •{ e s ? 

S W A P ♦ B Y B :i. s r' e « 1..1 i r b d o i"i t h e s \ii s t e in xJ :i. s k t o b v :i. ci <:i u p t i m e <s h a v 1 n si » 

Xt must be blf-5 enousUj to hold at .least two Jobs at tfie swstein swap 

in a i< ♦ W h e I'l t h e s \i{ s t e in :L s b r> o u si h t 1..1 p v S W A f •' ♦ B Y S w i 1 1 b e :l n t h e t h :l r' d 

swap f i :i. e p o lij :i. t i o n ♦ 

T \j p e ' N ' y '0 L D ' y o r < L I-' > f o r ri o c' h a n «? e i n s L a Iv t.,i «> ♦ 

Twpe 'YEB' to enter file data* 

BWAP»BYB chari'-Ses? YES 

Size? 

Type 'OLD' or <LF> to default to the ininiiinum s:i.ze of 6-4 blocks* 

Other wise? enter the file size in 256 word blocks* 

Size? 10*3:l.K 

Base? 

Twpe 'OLD'y 'O'l- or <I...F> to let RSTS find a location* 

Enter a 1 optical block number to locate the file at a specific 

place on the disk* 

Base? 20000 

SWA P ♦ 3 Y B c ha n <-i e s ? 

This file maw be used as an additional swappinsi file if it is 

i n s t a 1 1 e d a s ir> u c h d u r i n *=j s '■j s t e m <■> t a r l, ••■• 1..! p ♦ 

Type 'NO'y 'OLD'y or <I,..F> for no change in status* 

Twpe 'YES' to enter file data* 

BWAPO*SYS chansies? no 

SWAP :l. ♦ S Y B c h a n si e s ? 

T hi i s f i 1 e may be u *■* e d a s a n a d d i t i o n a 1 s w a p p i ri si f i !l. e i f i t i s 

i n s t a 1 1 e d a s <•> u c b d 1 j r i n si b "-j b t e in i» t a r t ■■ • 1..1 p * 

Type 'HO' V 'OLD's' or <LF> for no chansle in status* 

Type 'YEB' to enter file data* 

BWAP1*SYB chan«{es? NO 

BWAP3*SYB chan«{es? 

This file may be used as an additional swappin<^ file if it is 

i n s t a 1 1 e d <•} s s u c h d 1..1 r i 1 "1 si s h s t e m s t a v t •"• 1..1 p ♦ 

Type 'HO' 9 'OLB'y or <I...F> for no chan«<e in status* 

Type 'YES' to enter file data* 

BU)AP3*SYB chan.«{es? NO 

OVR.BYS chanjiJes? 

OVR*BYS may be uned to hold the non-resident system code if it is 

i i"i s t a 1 1 e d a s s u c b d u r i ri .<^ ii> y s t e in s t a r t -■ u p * 

T y p e 'HO' V ' L B ' y o r < L !•" > f o r' ri o c h a n si e :i. i"i s t a 1 1..1 s * 

Type 'YEB' to enter file data* 

V R ♦ B Y B c b a ri <-i e s ? n 

E R R * B Y S c b a n *-i e s ? 

ERR*BYS may be used to hold the system error messa;=!e text if it is 

i n s t a 1 1 e d a s s u c hi d u r i n si s '■..i <■> t e m s t a r t - i.,i p * 

T y p e ' N ' y ' L D ' y or < I... I" > f o r n o c hi a n si e i ri s t a t u s ♦ 

T »r* p e ' Y IE B ' t o e n t e r f i 1 e d a t a ♦ 

E R R' * B Y B c b a n si e s ? n 

B U F F * B Y B c b a n si e s ? 

BUFF* SYS is used for DEC tape operations* 
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It must contain at least 3 blocks per supported DECtape* 

BUFF, SYS is required on the system disk if DECtape is to be usedf 

Type 'NO'y 'OLD'y or <LF> for no chani^e in status* 

Type 'YES' to enter file data, 

BUFF ♦SYS chansies? YES 

Size? 

Enter the file size in 256 word blocks* 

Size? 6 

Base? 

Type 'OLD'!- '0'» or <LF> to let RSTS find a location* 

Enter a losiical block number to locate the file at a specific 

Place on the disk* 

Base? 

CRASH* SYS chansjes? 

CRASHtSYB is used to hold a dump of the monitor's tables 

if the system crashes and the crash dump option is enabled* 

7' '!:< p e 'NO'? ' L n ' y or < L F > for n o c h a n ^ e in s t a t u «> * 

Type 'YES' to enter file data* 

CRASH* SYS chanstes? YES 

Size? 

Ento3r the file size in 256 word blocks* 

Size? 80 

Base? 

T \:t p e ' 1... D ' > ' ' y or < L,. F > to 1 e t RSTS f i n d a :L o c a t i o n ♦ 

Enter a lo?.'.{ical block number to locate the file at a specific 

p 1 a c e o n t he d i i:> k ♦ 

Base? 

Other files? 

Type the NAME* EXT of a file to be created or deleted durin.<^ 

t h i s C H A N G E o p e r a t ion* T y p e < I... F > i f t h e r e «> r e n o in o r e f i 1 e s ♦ 

Other files? NO 

REFRESH suboption? EXIT 
Opt ion J DEFAULT 

No defaults bv<::> currently set in SYSOEN*SII.., 
You currently have J vJOB MAX -■ 2? SWAP* MAX •■■•- :I.6K* 
JOB MAX or SWAP MAX changes? 
JOB MAX or SWAP MAX may be chani-Jed as follows! 

:l. ) , J OB MA X in a y n e v e t' be <:J r* e a t e r t h a I'l 2 » w h i c h i <!> t h e J o b m a x i m u m 
s p e c :i. f :i. e d b t s y s t e m «i e i"i e v at t i o n t i m e » 

2 ) S W A l=" MAX? w h» i <;.' h i ii> e ;•( p r e s s e d i n K o f m e m o r *;* ( :l. K" "- :l. 024 w o r d s ) y m a v:i 
n ever b e d r* e s t e t' l, Y) a ri 3 .1. ( K ) o r 1 e s s t h b n B ( K ) * 

3) Each of the four possible swap files can hold N Jobs? where 

N '■■■■■■ i:Size of swap file (in blocks) 11 / i::SWAP MAX <K) * Al 
truncated to Bn inte*-ier* The sum of the N's for the four swap 
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files determines the number of Jobs which maw lo^ on* This number 
maw be increased on line by addin*3 swap files (up to a ma)<imum of 
Af includin?^ SWAFsSYS)!- but maw never exceed the JOB MAX specified 
at start-up time* 

4) The one reauired filer SWAP* SYS » must be at least CSWAP MAX * 83 
blocks lonj-iy so that it can hold two Jobs* 

Twpe 'YES' to chan.^e JOB MAX or SWAP MAX* Twpe 'NO' to leave the 
iflaxima as thew stand* Anw changes? YES 

New JOB MAX? 

Twpe 'NO' if wou don't want to chani^e the current JOB MAX* 
To enter a new JOB MAX? twpe a number between :l and 2* 

New JOB MAX? 2 

New SWAP MAX? 

Twpe 'NO' if wou don't want to chansJe the current SWAP MAX* 
To enter a new SWAP MAX? twpe a number between S and 31 <K)* 

New SWAP MAX? ;31 

You currently havet JOB MAX ==•• 2r SWAP MAX =='= 31K* 

JOB MAX or SWAP MAX chansJes? NO 

Ruri Time Swstem? 

Specifw the name of the Run Time Swstem to be used as the swstem 
default* The named Run Time Swstem must exist on the swstem disk 
:i. i-i B c c o u n t i:: y :l. ::i w i t h e X t e n b i a n ' ♦ R "I' S ' * 

D i r e c t o r 1:J o f a 1 1 v a 1 i d r u i"i t i m e s v* i;> t e in s t 

RT:i.l*RTS 

Name of default Run Time Swstem? RT;IJ. 

E r r o r' in e <i> ii> a <;i e f i I e ? 

S p e c i f •:■.{ t h e n b m e o f a f i 1 e i n L ? 1 :3 with e x t e n <•> i o n ' * IH: R R ' 
which contains the RSTS/E error messas-ie text* 

n i r' e c^ t o r <■.■.{ o f v a 1 i d e r r' o r' m e s s a <-5 e f i 1 e s t 
ERR* ERR 

Name of error message file? ERR 
:i; I'l s t B 1 1 B t i o i-i n B in e ? 

Enter the installation name as a strin«{ of up to 15 characters* 
New installation name? RBTS/E SYBOEN 
M e in ID r <■.■.{ b 1 1 o c b t i o n t a b 1 e ♦ 

OK? 00000000 •••• 00:1.27777 < 22K) t EXEC 

22KJ 00130000 •• 00147777 ( A\<) i RTS (RTll) 

26Kt 00150000 ••" o;)i-/yyy"/7 ( 486K) t USER 

512K? 04000000 •• End ** NXM 

T B b 1 e s i.,i b o p t i o n ? E X I T 
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You currently have crash dump disabled* 
Crash dump? 

Ts:fr-i? 'YES' to enable crash dump at startup time* 
Twpe 'NO' to disable crash dump. 

Enable crash dump? YEB 

M a «i t a p e 1 a b e 1 1 i i "i <^ d e f a u 1 1 < n o n e > ? 

Type 'ANSI' to select ANSI standard masJtape labellins-f for system default. 
Twpe 'DOS' to select DOS format ma<.i«tape labelling for system default. 

M a *S t a p e 1 a b e 1 1 i n ?•$ d e f a u 1 1 < n o n e > ? D S 

Preferred clock <P 100>? 

Choose the clock whichi' if available^ should be used c\urinsi timesharing-?. 

Type 'L' to use the KW:LJ.-L line freGuencw clock. 

Type 'P' to use the KW:1, 1-P prosHrammable clock. 
J\jr'e <LF> for no chans-je. 

Preferred clock <P 100>? p 

1 n t e r v u p I f v e « u e n c \:{? 

Type 'LINE' to use the KW:U.~P at AC line frequency. 

Type a multiple of 50 between 50 and J. 000 to use the 

KWii-P crystal clock at the specified interrupt freouency. 

1 i-i t e r' r u p t f r* e g u e i"i c •■.■.{ ? 1 

D 3 1 e f o T' in a t < A 1... P H A B E T 1 C > ? 

Type 'A' or 'N' to choose the format for the system date. 

Type ' A L P IH A B E T 1 C ' f o v a 1 p h a b e t i c d a t e < e . ?-J . 3 1 ••■• D e c • •• 76) * 

Type 'NUMERIC for numeric date (e.s$. 76.12.3:1). 

Type <I...F> for no chan.<-{e. 

Date format <ALPHABET1C>? A 

T i in e f o r m a t < A M / P' M > ? 

Type 'AM' or '24' to choose the format for the system time. 

Type 'AM/PM' for AM/PM format time <e.<-«. 0.1. J 30 PM). 

T y p e ' 2 4 -- H U R ' f o r n i..i m e r .i. c t i m e ( e . <•« . 1 3 {30). 

Type <I...F> for no chan<-Je. 

Time format <AM/PM>? AM/PM 

Power fail delay <:l>? 

W h e i-i p o w e r i s r e s t o r* e d s f t e r a p o w e r f a i 1 u r e » R S T S / 1;:.' w i 1 1 
delay the recovery for 1 to 300 seconds to allow all 
devices to become ready. Specify the number of seconds 
you want to delay. 

Power fail delay <1>? 300 

Option: SET 

S E T s I..I b o p t i o i"i ? 

Kf a 1 i d SET s u b o p t i o n s a r e ♦ 

LIST List the status of a device 

M D E M I:-; ri a b 1 e m o d e in c o n t r o 1 f o r* k e 'j b o a r d s 

1. C A L .D i i:> a b 1 e m o d e m c o n t r* o 1 f o r* I-:, e y b o a r d s 
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LP Set Line printer characteristics 

D:i: SABLE Disab:i.e a device unit 

ENABLE Enah-.»:i.e a device unit 

PRIM Make device ownership pri vile sled 

I J N I"' R" I U M 3 k e d e v i c e o w ri e r s h i p n o n - p r i v i I e si e d 

EXIT (or <LF>) exit from SET option 

Onl':* the first two characters need be twped 

S I::! T s u h o p t i o n ? L I B T 

Device? 

Type the name of the device to be listed* 

To list selected units y twpe a unit number or ransie* 

Type <LF> to list all devices* 

Device? LP 

N B m e C o n t r* o 1 C a m m e n t s 

LPO L PO t NOOM I TCR v CR y NOEOT f F I LL f NOCDNTRDL 9 NDVT AB 9 BSEMUL ATE 9 w i dth 80 

S E. J s u b o p t i o n ? I„. P 

Type ( NOOM I TCR s- CR 9 NOEDT 9 F I LL 9 NOCONTRGL t NGUT AB 9 BSEMUL ATE ) ? 

S p e c i f y t h e 1 i ri e p r i n t e r^ t w p e ( I... I-' 9 L S 9 I... V y or L A .1. 80)* 

If the line printer is none of these y type individual 

characteristic names s- separated by commas* 

T h e c h a r b c t e r i s t i c ii> b r e ♦ 

OMITCR Omit send ins? <CR> if next character is <LF> 

NOOM IT CR Always send <CR> to the printer 

CR Irisert <CR> before <LF>y <^T>9 Bnd <FF> 

NOCR Printer performs implied <CR> before <LF>r <yT>y <FF> 

F 1 1... I... I n i;> e r t f i 1 1 b f t e r f o y- irt f e e d s 

NOFILL Fill is not required after form feeds 

C N T R 1... S e n d ri o n •■■• p r i n t i ri <:i c h a r a <:.^ l, e r s t o t h e p r i f"i t e T' 

N C N r 1^ 1... D i s c a r d n a n ••• p r* i t"i b i n «? c^ h a r a c t e r s or 1..1 s e u p a r r o w in o d e 

EOT Send EOT <"D) to the printer 

NOEOT Treat EOT like other non-printins$ characters 

MTAB Send vertical tabs to the printer 

N M r A B T r^ e a t v e r t i c^ b 1 t b b s 1 i k e o t h e r n o 1 "i - p r i n L i n <-i c Jj a r a c t e r s 

BSEMUL ATE Emulate the action of 'backspace' on the printer 

BSREAL Printer has real backspace (carria<^e moves left) 

BS CONTROL Treat backspace like other non™printin«< characters 

Unspecified characteristics take the followin«{ defaults* 

NOOM I TCR !- CRy NOEOT y FILLy NOCONTROLy NOMTABr BSEMUL ATE 

Type <LF> to leave the characteristics alone* 

The defined printer types Bret 

LP '^■■' OMITCR y NOCRy NOEOT y FILLy NOCONTRGL y NGVTABy BSEMUL ATE 

i g ^^=: NOOM I TCR y NOCRy EOTy NOFILL y NOCONTRGL y NGVTABy BSEMUL ATE 

1 B ■■'^' NOOMITCRy CRy NOEOT y NOFILL r CONTROL y MTABy BSEMULATE 

LA 180 ■■^■■■- OMITCRy NOCRy NOEOT y FILLy NOCONTRGL y NGMTABy BSREAL 

What is the type of this line printer? LP 

Width (80)? 

Specify the width of the printer line as a number between 

;i. and 254* 

T ^i^ p © < L I'" ;:=• t o 1 e a V e t h e w i d t h u n c h a ri «! e d * 

What is the width of the line printer? l^S 

Lower case (no)? 

Type 'YES' if the line printer has lower case capability* 

Type 'NO' if it does not* Type <LF> for no chansJe* 

Does this printer have lower case? YES 

SET suboption? EXIT 

OptioriJ START 
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You currentlw have^: JOB MAX "" 2!- SWAP MAX ■"" 3:I.K 

JOB MAX or SWAP MAX ch»ndt?s? 

JOB MAX or SWAP MAX maw be chans-jed as follows J 



1) JOB MAX inaw nevor bo <^{^eator than 2y which is the Job maximum 
sy-^ecifiod at system Jiieneration time* 

2 ) SWAP M A X y w hu c h i s o x p r e s s e d i n K o f in e in o v ^.f ( :!. K' -■■ :l. 2 4 w o t' d s ) ? in a y 
n e V e f b e j-J r e «> t e i' Iv h <:j i "i ;'J 1 ( K) o t' 1 e s s t h a n B ( l< ) ♦ 

3) Each of the four possible swap files can hold N Jobsc where 

N ■■"■■ CSixre of swap file <in blocks):.! / liSWAP MAX (K) * 4:3 
truncated to sm intesfer* The sum of the N's for the four swap 
files determines the number of Jobs which maw loi^? on» This number 
maw be increased on line bw addiniJ swap files (.up to a maximum of 
4y includinsf SWAP. SYS)? but maw never exceed the JOB MAX specified 
a t s t a r t • •■• u p t i m e ♦ 

4) The one required filey SWAP* SYS y must be at least LSWAP MAX * 8::i 
b 1 o c k s 1 o i"i «5 y s o t h a t i t c a I'l h o 1 d t w o J o b s « 

Twpe 'YES' to chan<;.<e JOB MAX or SWAP MAX. Twpe 'NO' to leave the 
maxima as the\:i stand* Anw chan^'Jes? NO 

A I "I i: J m e m o r w a 1 1 o c b t i o n c h a ri sf e s ? 

:i: f \:{ o u w i s h t o s p e c' i f w <•:> c e r' t <ft i n p o r t i o n o f m e m o v w m s i..i ri a v <ij :i. 1 a b 1 e t o 
R B T S o r iff s d e d i c a t e d !■;.> i..i f f e r s p a c e y o r i f '■j a u w i s h t o 1 o c a t e t h e R 'J i "i T i m e 
S <■.:! s t e m a t <•> o m e <■; p e c i a 1 a d d r e s s ( e ♦ <=! ♦ i i-i M S m e m o r s-j ) y a n s w e r^ ' Y I::: S ' ♦ T o 
leave the memorw allocation unchan;/Jed from the last specified table y 
answer 'NO' . 

Anw memorw allocation chanS'Jes? NO 

You cur rent Iw have crash dump enabled. 

Crash dump? 

Twpe 'YES' to enable crash dump at startup time. 
Twpe 'NO' to disable crash dump. 

Enable crash dump? YES 

22"Apr-"79? 

Ente r date as ' BAY-MONTH- YE AR ' (iB^f'i*? 3 1 -■BEC--7 6 ) 

a r as ' YEAR ♦ MONTH . DAY ' ( e . <•? . y 76 .12. 3 1 ) ? 22- APR - 79 

06? 22 PM? 

Enter time as 'HOUR 5 MINUTES AM' or 'HOUR I MINUTES PM' (e.d. It 15 PM) 



or in 2 4 -"hour 

DFOJ disabled 

DLOt disabled 

i:iLlJ disabled 

BPOt disabled 

DPI J disabled 

DBOJ disabled 



format as 'HOUR J MINUTES' (e.<-«. 13t:l,5) ? 06 J 22PM 

I'l o R F t c o n t r o 1 :i. e r 

ri o R' I... ♦ c o n t r o 1 1 e r 

n o R I... ♦ c o ri t r o :i. 1 e v 

n o R P * c o ri t r o ]. 1 e r 

n o R I-' t c o ri t v die r 

u n i t i"i o t pre s e ri t 
MTOJ disabled - no TMi controller 
MTU disabled ••• no TMJ controller 
MSOJ disabled ■■•• no MSOt controller 
MSI I disabled ••• no MS:I. J controller 

1 d e V i c e s d i s a b :L e d 

? C a n ' t f i n d f i i e o r a (:.• c o u i "i t 
. M U N T B M 1 1 S Y 3 G N G / R' 
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♦ R riMltCREATE.SAV 



HELLO 1/2 
Password* 
1. other user :ls lojlsfed in under this account 



♦ASSIGN DMIJ IN 

♦R INJPIP.SAV 

>KSY : $* ♦ *<2;52>:==IN J *LOGIN ♦ SAV y *LOGGUT ♦ SAV » iHPIP ♦ SAV 

*SY : $* ♦ *<104>«=:IN J *UTILTY ♦ SAV 

>KSYJ<**»>K<104>=^IN:i|iMACRG»SAV!'$CREF»SAy»*LINK»SA<v' 

*SY t ** ♦ *<i04>-=--'IN : f SILUB ♦ SAV 9 $HGGK . SAV y $SY8GEN ♦ SAM 

>KSY i $* ♦ *<124>-*IN : HiSYBBAT ♦ SAV 

*BY J $* ♦ *<.t04>-'<i:N J $ONLPAT ♦ BAM 

)KDK t ** ♦ *< 40>«"" I N : $ERR ♦ BTB x *P I PS A V ♦ TXT 

!KBY J LO » 1 :.1* ♦ *<40>:==IN { fTECG ♦ RTB 

*B Y : 1: » .1. :i * ♦ >K/MG J 1 6;=':B Y ti: s- 1 :3 TECO ♦ RTS 

*SY J $* ♦ *<:L04>/RTB J TECG=.<I:N t iliTECO ♦ TEC 

♦DEABBIGN IN 

♦DISMOUNT imit 

♦R LOGOUT 

Confirm? Y 

Saved all d:i.sk files? '576 blocks in use 

Job 2 User 1. ^2 Ios-«<iJed off KB:l. at 22-AFr "79 06 J 28 PM 

1 other user still Io«5«{ed in under this account 

System RBTS K}7*0-07 RBTS/E SYSGEN 

r\' 1..1 n t i m e w a s 1 ♦ 7 s e c o 1 "1 d s 

Elapsed time was :1. minute 

Good evenin<-« 



**22-APT 79>K>K 



Be<-{innin«« of RSTB/E swstem f^ieneration ♦ 



Questions come in lond and short forms ♦ 
If v;Jou are familiar with themn answer 
" B " f o r s h o r t P o t h e r w i s e ? i-t n s wet* " I... " f o r 
Ion«f form^ 

Form ? #B # 

Questions come in lond and short forms + 
:i.' f *;j o u <••} r e f a m i I i a r w i t h t h e m y b n s w e r 
"B" for shorty otherwisey answer "L" for 
I on si form* 
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Forin ? #B # l 

T h> e s\:! <:"> t e in w :i. .1. 1 a u t a in a t i c «> J. il «j s 1..1 p p .1. '■J 
aniswers to a 1.1. of its prompts* You have 
the opt.i.on of accept. i.n.<;« the answer y 
is 1..1 p p .1. «;f :i. n <:i a d :i. P f e r' e ri t a ri <■> w e i' ? o r 
T' e a u e s t :i. n «< t h e f u 1 1 p t' :i. n t e d in e s s a .*^.{ e » T ii e 
hardware answers wJ..'l. .1. be meaniniif ul only 
.if *Jou Bvat .'•{eneratin*-! a system for the 
computer that \:tou are currently running-? 
on* If wou are ^^{eneratin?-! a system for 
t h i s c o in p 1..1 1 e r 9 t ^j p e " Y l-i: S " s! cj t h e r w i s e y 
type " NO " . 

Same system ? #Y # YES 

The RBTB/E system is distributed on 
in a .«.{ t a p e 5 1"< K" 5 < D K ) y R' 1... .1. ( l\ I... ) ? a i". d R K 6 
and RK07 (BM) cartridiiie disks? or may 
B 1 r* e a d »:S have b e e ri t r a n i;> f e r r* e d b o t h e 
*s \:t s t e in d i s l<. ( 9 Y ) ♦ l»' o r in a <:i t b p e y a d i s - 
ti net ion must be made between the TUlOy 
TElOy BVid TS03 drives y which use the 
d e V i c* e I'l b m e " H T " y t h e 'I' l,J ;l. 6 y T E :l. <f> y T U 4 5 y 
and TU77 drives y which use the device 
1-1 a m e " M M " y a n d t \) e T {■> 4 d r i v e y w h i c h 
u s e s t h e d e v i c e n a m e " M B " ♦ E n t e r l h e 
type of distribution medium for this 
s y s t e in i?i e n e r a t i o n ( M T y M M y M B y H l< y D I... y 
i:iMy or BY)» 

Distribution medium ? #.K:iM# DM 

The s?ene rated system can be written onto 
t h e c^ 1..1 r r' e i"i t s 'nt s t e m d i s k ( B Y ) J a ri o t h e i' 
disk drive (DFy DK y DL.y DMy DPy DRy or 
D B ) J T U 1 y T E .1. y o t* T B 3 in a <;i t a p e < M T ) y 
TUlAy TE16y TU45 y or TU77 masrlvape (MM)? 
J S 4 m a <:i t a p e ( M B ) y or D E C; t a p e < D T ) « 
Usins-J the current system disk (BY) as 
the output medium is recommended only if 
the system type is DMy DPy DRy or DD« 

Output medium ? fSYf by 

RF disk drives have limited stora,<.;fe cap-- 
a c i t y t 1 f B n R !••' d r i v e i s b e i n i-i u s e d b s 
the system disk durin.*^ the BY BO) EN pro • 
c e d u r e y f i 1 e s w i 1 1 h a v e t o b e d e 1 e iv e d 
from that disk after they are used* When 
the system disk is b\"\ RK05 or RLOl Bfid 
o 1..1 1 p u t to BY hi a s b e e n c h a s e n y f i 1 e s w :i, 1 1 
also have to be deleted after they Bre 
used to leave enou.<-{h room for the system 
library* Should files be deleted after 
they are used (YES or NO)? 

Delete files ? #N0# NO 

;i! f t h e r e i b a .1 i ri e p r i n t e r a v a i 1 a b 1 e f o r^ 
use dur in?.'? BYSGEN it may be used to 
print the system load maps andy 
o p t i o n a 1 1 \:i y t o p r^ i n t b b s e in b 1 "-J 1 i <» t i n ;.-i ■;■; 
of the system tables Btid terminal 
s e r V i c e in o d u 1 e s ♦ 1 f '■j o u hi b v e a p r^ i n t e r 
and want the assembly listin<i«s and/ or 
;i. o a d m B p s p r i n t e d d u r :i. n ^.^.f S Y S G E N y b n s w e t^ 
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"YES"* Otherwise answer "N0"» 

LP for SYSGEN ? *Y * NO 

This pro.*lraiYi can be used to slenerate a 
lYionitor and/or a BASIC-PLUS Run-Tiina 
Swstem* Do wou wish to sJenerate a 
monitor (YES or NO)? 

Generate monitor ? =8=Y # YhS 

The monitor Save Iiiia«{e Librarvj (SID 
will have a name of from 1 to 6 alpha- 
numeric characters mnd an extension of 
" S 1 1. " ♦ P 1 e B s e s f-' e c' i f w t ^^ e n a in e w o u w a n t ♦ 

Monitor name ? *RSTS# RSTSM7 

The system <-<eneration process can auto- 
matical 1^.* patch the «iene rated monitor* 
You must have a monitor patch file on 
anw RSTS/E file structured medium* Would 
^riou like to automatically patch the 
fi{ene rated monitor (YES or NO)? 

Monitor patch in<-,f ? #??* i^O 

You have the option of «jeneratinj.-s the 
B ASIC- 1"' 1... I J S R u n - T i m e S \it b t e m i n a d d i t i o n 
to <-{eneratin<-{ the monitor* Do wou want 
to ii^enerate BASIC-PLUS at this time 
(YES or NO)? 

Generate BASIC-PLUS ? #Y * YES 

The BASIC-PLUS Save lma««e Library (SIL) 
will have a name of from 1 to 6 alpha™ 
n u in e r* i c c^ hi <•!! r b c t e t' «> a n d a n e x t e n s i o i"i o f 
" R T S " « I"' 1 e a s e <■> p e <:^ i f \:i t h e n a in e S:f o i..i w a n t * 

BASIC PLUS RTS name ? #BAS1C# BASIC 

The swstem "feneration process can au to- 
rn a t i c B 1 1 i:i p a t c h t h e f-i e n e r a t e d B A S I C - 
PLUS* You must have a BASIC-PLUS patch 
file on some RSTS/E file structured 
in e d i u in * W o u 1 d \:t o i..i 1 i k e t o a u t o m a t i c a 1 1 •■.■.! 
r-atch the i^enerated BASIC-PLUS (YES 
or NO)? 

BASIC- PL US patch in<i{ ? *??* NO 

Y o u h a V e t h e o p t i o i"i o f i n s t a 1 1 i i"i <•{ R S X 
or BASIC- PLUS- 2 as the system default 
run- time system* Will you want RSX as 
the system default run-time system 
(YES or NO)? 

RSX as default RTS ? #N0# NO 



Now you must specify the hardware con- 
fi«!uration on which this RSTS/E system 
will run* 



The next few questions deal with the 
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nuinbers and types of teririinal interfaces 
on the system* 

S e r :i. a ;i. A S C 1 1 t e r^ in :i, i "i a :i. s c o n n e <- 1 e d d :i. r e c t •■•■ 
Iht to the computer and those connected 
throus;5h leased pr:i.vate telephone I ;i.nes 
(not d:i.a:i.-up) may use either of two 
classes of s:ln<=«le line interfaces (or 
i:i e V e v^ a I in u :i. t i p ;i. e x e r^ s » d :i. s c u s s e d 1 a t e t> ) * 
T h e f i r s t c I a b s :i. ri c 1 u d e <-i t h e K I... :1. :l. y l.„ C :l. :l. ? 
DL:l. lAy and DLl :I.B interfaces* Specify the 
total number of these sin<>ile line inter- 
faces (1 to 16 ■■•• include the console 
terminal ) * 

Ki„. 1 1 V 1...C 1 :i. 9 m.. 1 1 A y HI... ;i, i b ' s ? *o i % i 

T h e s e c o ri d c? 1 <:} s s <:> f <•> i n :i^ 1 e 1 i n e :i. ft t e r 

f a c e i!i f..i s. e d to c o ri ri e c t t e r m i ri <ij 1 1;> 1 o c. a 1 :i. s; 
c:) I' tin* o u .<■{ f 1 1 e b <•; e d iv e .1 e p h o n e :i. i n e i:> ( i "i o t 
dial --up) includes the DLllC and DLllD 
:i. n t e r f a c' e s * l-l o w in <•:> n *j D 1... 1 1 C ' i;> <:j ri d D I... 1 1 B ' «> 
are on this system (0 to 31)? 

riLllC)- DLllD's ? ^KOO* 

There BVi'-; two kinds of individual inter 

faces for automatic answer datasets used 
<.•) n t h e d i a 1 - u p t e ;i. e p f n o ri e ri e t w o r^ V-. * T' fi e 
first of these is the DCll* How many 
DC 11 -DA lines do you have (0 to 32)? 

DCll's ? >K00* 

T h e <•!. e c o n d I-;, i n d o r i n d i v i d u ;;> ;i. 1 i ri e 
dial-- UP interface is the BLUE* How many 
D I... 1 1 E ' s a V e o ri l, h i s s \.{ <;> t em ( t o 3 1 ) ? 

BLUE'S ? >K()0* 

i;;: a c h B J 1 1 m I..I !l. t :i. p 1 e x e t' c' a n c' o ri ri e c t u p l, o 
16 terminals to the system* Please enter 
the total number of BJll's attached to 
t h i s s y s t e m ( t o 1 6 ) « 

BJll's ? >!<00* 

Each BHll multiplexer can connect up to 
16 terminals to the system* Please enter 
t h e t o t a 1 1-1 u m b e t' o f B H 1 1 ' s a l.. t a c h e d t o 
t h :i. s s •:■.{ s t e in ( t o 1 6 ) * 

BHll's ? *03* 3 

i~ o r t h i <i> B H 1 1 u n i t y e i-i t e r t h e n u m b e r o f 
1 i i"i e s w h i c h w i 1 1 b e i„i i;> e d n o w o t' i n t h e 
f o V s e e <•} b ;i. e f u t i..i re* A re s p o n s e c:) f 16' w i 1 1 
permit all lines to be used* If the num- 
ber of lines enabled (n) is less than 16 
RSTS/E will not be confis-fured for and 
w i 1 1 I'l o t r e c o <;i n i z e 1 i i"i e s n t h r u 1 5 o n 
this BHll unit* Enter the number of 
1 i n e s e i-i a b I e d ( t o 16)* 

BHll unit 00 lines enabled ? #16# 16 
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riH:ll unit 01 lines enabled ? #16* 16 

DHll unit 02 lines enabled ? *16* 16 

Dial-ur- telephone lines can be connected 
throusJh an automatic answer dataset to 
a DHll multiplexer with a DM11~BB modem 
controller* Note J all DHll -All's include 
a DM11~BE< as an intesJral part of the 
DH11» If wou wish to include support for 
datasets on DHll's answer YES* Otherwise 
answer NO* 

riataset support for DHll's ? *N0* NO 

Each DZll multiplexer can connect up to 
B terminals to the system* Please enter 
the total number of DZll's attached to 
this swstem (0 to 16)* 

DZll's ? )KOO)K 

Pseudo keyboards permit interactive Jobs 
to be run without tyin?J up a real termi™ 
n a 1 ♦ T h e w ave p y* i in a r i 1 w i n t e n d e d for u s e 
bw a batch control pros^ram which feeds 
commands to one or more pseudo keyboards 
d e d i c a t e d t o r u n n i n <-i b a c k s$ r o i..i n d t a s k s ♦ 
I "I o w in a n \i{ p s e i..i d o k e y b cards wo u 1 d y o i„i 1 i k e 
to have (1 to 127)? 

Pseudo keyboards ? *04f 12 

RSTB/E is capable of support ini^j IBM 2741 
c o in p a t i b 1 e t e r in i ri a 1 s o n D L 1 1 D y D L 1 1 E ? 
and DC 11 sin«n.e line interfaces^ or on 
DHll or DZll multiplexers* If you do not 
w a I "I t a n ^:i! 2 7 4 :l, s u p p o r t t h e n a n s w e r* " NO"* 
1 h e T' w i s e a n <•> w e r* " Y E S " * 

2741 support ? fNO* NO 

An optional feature of the RSTS/E termi- 
nal service allows one Job to interact 
w i t h s e V e r a 1 t e r* in i n a 1 s t h r o u <•{ \\ s p e c :i. a 1 
forms of the Record 1/0 GET and PUT 
statements* This feature is useful in 
a p p 1 i c a t i o n s w h e r* e t h e s a m e b a s i c f i..i n v •■■■ 
tion is performed on several terminals 
and a separate Job for each is undesir- 
a b 1 e o r a t 1 e a s t i ri e f f i c i e ri t ♦ W o u 1 d ^i* o u 
like to include this feature (YES or NO)? 

Multi -terminal service ? #Y # YES 

Echo control is an optional feature of 
the RSTS/E terminal service which allows 
a n \:{ f u 1 1 d u p :I. e x t e r m i r-i a 1 t o f u n c t i o n 
like a block mode terminal* This feature 
enables a proj-«rain to define fixed leiu^th 
input fields and to defer echo in «< of all 
t \:f p e d c h a r a c t e r* s u ri t i 1 t h e \:t a v e a <:.' t u a 1 1 y 
requested* It is useful in data entry 
a p p 1 :i, c lis t i o i"i s <.) r w h e r e v e r t h e a p p e a r a n c e 
of terminal output must be precisely 
controlled* Would you like to include 
this feature in your system (YES or NO)? 
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Echo control ? *Y * YES 

The RSTS/E tenninal service can be built 
to respond to CTRL/T bw print inj^ 3 one- 
line status report describing the Job's 
status* This report includes the Job 
name? RTS name? run states Job ^nd RTS 
sieesy and total and incremental CPU 
times* The Job is not disturbed when the 
report is printed* Would wou like to 
have this fc^ature in wour monitor (YES 
or NO)? 

One- line status report ? *Y * YES 



The next Questions deal with the numbers 
and kinds of disk units on this system* 

The RFll controller is used to control 
UP to 8 of the RSl:l, 2'56\< word fixed- he ad 
disks* If this system has none of these 
disksr answer NO 5 otherwise^ answer YES* 

RE/RSll's ? *N0* NO 

The RS04/RS03 disk system consists of an 
RHll device controller Bnd from one to 
oij^ht RS03 <256K) or RS()4 (512K word) 
fixed-head disk drives* Please enter the 
total number of RS03 and RS04 drives on 
this system (0 to B)* 

RS03/RS04's ? *02* 2 

T hi e R K :L 1 c o n t r o 1 1 e r i s u s e d to ao ri t r o 1 
UP to B of the RKOS 1*2 million word 
iTiovin.<!i~head cartridi?ie disk drives* Note 
that an RK05F is equivalent to 2 RKOS's* 
How many RKOS drives bvb there (0 to B)? 

RK05's ? *0B* 2 

By usinsJ the overlapped seek drivers- you 
can increase the efficiency of disk 1/0 
at the expense of some memory* Type 
YES to use the overlapped seek driver* 
Type NO to use the non-overlapped seek 
driver* 

Overlapped seek ? *Y * YES 

The RLll controller is used to control 
ans:! combination of up to four RLOl (2*6 
million word) or RL02 (5*2 million word) 
top loadinj-f cartrids^e disk drives* Enter 
the total number of RLOl and RL02 drives 
an this system <0 to 4)* 

RL01/RL.02's ? *00)K 

The RK611 controller is used to control 
any combination of up to eisiht RK06 <6 
in i 1 1 i on word ) or RK07 ( 1 2 m i 1 1 i on word) 
top loadinsJ cartrid*:Je disk drives* Enter 
the total number of RK06 and RK07 drives 
an this system (0 to B)* 



E-82 System Generation Examples 



RK06/RK07's ? >K02* 2 

Overlcfpf^ed seek ? *Y * YEB 

The RP:I. :i. c on t roller is used to control 
B n w c^ o in b :i. n a t :i. o ri o f i.,i p t o e :i. <ii h t R P 2 ( 1 
in i 1 1 :i. o n w o r d ) o r R p 0'3 ( 2 in :l 1 .1, i o n w o r d ) 
inov.i. n«S""head d:i.sk pack dr;i. ves* Enter the 
total number of RP()2 and RP03 drives on 
t h i s <:j \:i s t e in < t o B ) ♦ 

RP02/RP03's ? >K00* 

Tfie RM02/3 disk swstein consists of an 
RH:i. :l. controller Bnd up to ei<.-Jht RM02 
or RM03 mo vinsi- "he ad disk pack drives* 
Twpe the total number of RM02 or RW)3 
d r i V e s i n t h i s c o n f i ?.•« u r b t i o n < t o 8 ) ♦ 

RH02/RM03's ? *02* 2 

Overlapped seek ? *Y * YEB 

The RP04/S/A disk swstein consists of an 
R H ;L 1 c o n t r o 1 1 e r <i) ri d a i"i w c o in b i n b t i <:» n o f 
I.J p 1 1:) e i ;;f h t R I-' 04 (44 in i 1 1 i o n w o vd) y R P S 
(44 m i 1 1 i o n w o r d ) ? o r' R' P 6 (88 m i 1 1 i o ri 

word) inovin.«? head disk pack drives* Type 

the total number of RP04!' RPOS? Bnd RP06 
d r i V e s i n t h i s c o n f i «{ i..i r b t i o ri ( t a 8 ) * 

RR04/RP05/RP<)A's ? *02>K 2 

Overlapped seek ? >KY * YEB 



The next few Questions deal with the 
p e r' i p h e r' a 1 d e v i c e <•> b 1 1 a c:* h e d t o t h i s 
RBTB/E swstem* 

The TU16/TE:l.6 mas? tape system consists of 
an RM:l.:l. massbus interfaces- TM02/TM03 
controller and from one to eiJiJht TUiA* 
TE16y TU45y or TU77 drives* If this 
swstein has no TU:l.6y TE16y TU45!' or TU77 
I n B ;:i t a p e d r i v e <•> b n s w e r J o t h e r* w i s e » how 
inanw TU16y TE:l.6y TU4'5!' and TU77 drives 
i:o?xist on this sv^stem (1 to 8)? 

TU16/TEl<f>/TU45/TU77's ? #08* 3 

The TM :l. 1 /TMA 1 1 /TMB 1 1 masrlvape cent ro 1 1 e r 
can support up to ei^^iht TUiOi' TEIO? or 
rB03 masJtape drives* Please enter the 
number of TUIO? TElOy Bnd TB03 drives on 
this system (0 to 8)* 

Tu:i.o/Ti*;:i.o/TS03's ? jkoo* o 

The TS04 masrLape system consists of a 
TS:l.;l. controller Bnd a TB04 drive* RSTS/E 
supports UP to 8 TS04 systems* If this 
system has no TS04 mai'^tape drives answer 
iJ o t h e r w i s e a h o w in a n si T S 4 ' s e >c i s t o n 
this system <1 TO 8>? 

TB04's ? ){«)0* 
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The TCll BECtape control ler can control 
UP to B sln<-{le drives* If th.i.s is w stein 
has ri o D E C t a p e b t a 1 1 y b n s w e r Or o t ^l e r - 
wisey how inanw s:ln<'{le DEC tape drives? 
not TUSA's? are there (1 to 8 " note 
that e a c hi T U 5 6 d u a 1 drive h» a s 2 ) ♦ 

DECtapes ? t08* 2 

The TU58 DECtape-lI system consists of 
t w <:) d T' i V e s a ri d a c o ri t r o 1 1 e t* f c o n n e cr t e d 
throi..i«<h a DLll interface* RSTS/E sup- 
ports UP to four TUSB systems for a 
maximum of ei.<-?ht drives. Please enter 
the number of TU58 drives attached to 
this system <0 to 8>» 

TUSB's ? *00* 

The RSTS/E system can have up to eii-Sht 
1 i n e r^r i n t e r s o f t h e I... 1==' 1 1 r L S 1 1 y o r L <J 1 1 
type* These printers Brn^ referred to by 
the device names LPO* throus^h LP7J* If 
there is no 1 i n e p r i n t e r y a n s w e r' y 
otherwisey enter the number of printers 
( 1 to 8 ) ♦ 

Printers ? >K01* l 

The RXll or RX211 floppy disk system 
consists of a UNI BUS interface and Bri 
RXOl (sin^^le density) or RX02 (double 
density) floppy disk subsystem* The RXOl 
and RX02 each include a disk controller 
and two floppy disk drives* RSTS/E 
supports UP to f o u r R X .1. 1 or Fi; X 2 :i. :L 
systems for a maximum of ei;.^ht drives* 
Please enter the number of floppy disk 
drives attached to this system (0 to 8)* 

RX0i/RX02's ? #08* 2 

Does this system have a CRll punched 
card reader or a CM 11 marked card reader 
<YES or NO)? 

CR 11 /CM 11 card reader ? *NG* NO 

Does this system have a CD 11 hi«?h- speed 
r-unched card reader (YES or NO)? 

CDll card reader ? *N0* NO 

Is there a hi?Mh~speed paper tape reader 
(YES or NO)? 

P*T* reader ? *ND* NO 

Is there a hisih-speed pbf'&v tape punch 
(YES or NO)? 

P*T* punch ? *N0* NO 

The DMCll network link is a synchronous 
communication line interface which imp- 
lements the DDCMP line protocol in hard- 
ware* At least one unit is required for 
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DECrKst communi cat ions* How msnw DMCll's 
43 re attached to thi<i> swstem <0 to 16)? 

DMCll's ? *06* 6 

DECnet/E is a set of modules which iiiip™ 
leinent the network services protocol 
and user interfaces required for DECnet 
communication* The DECnet/E software is 
sold and distributed as a separate pack- 
a tie* It is not included in the standard 
RSTS/E kit* no wou have a DECnet/E kit 
and wish to include DECnet support in 
this swstem (YES or NO)? 

DECnet network support ? #Y * YES 

The DECnet/E packas^e is distributed on 
iT.aj.nape? RK05 (BK) ? RLOl <DI,..)? Biui RK06 
and RK07 (DM) cartridste disks? or maw 
alread*.-* have btsen transferred to the 
s w s t e m d i s k (BY)* I-' o r m a «< t &pev a d i s ~ 
ti net ion must be made between the TUlOi" 
TElOy and TB03 drives » which use the 
device name "MT"? the TU16f TEI69 JUA'Of 
and TU.77 drives? which use the device 
i-i a m e "MM"? a n d t he T S 4 d r i v e y w hi i c h 
ij s e s t h e d e v i c e n b m e "MS"* E 1 "i t e r t h e 
type of distribution medium for this 
DECnet/E steneration (MTy MMs- MS? BK? DLr 
DMv or SY) * 

DECnet/E distribution medium ? *DMf DK/A 

The system <.-ieneration process can auto™ 
in a t i c a 1 1 <■.■.{ p a t c h t h e <•? e n e r a t e d D E C n e t / IE! 
support* You must have a DECnet/E patch 
file on anw RSTS/E file structured 
in e d i 1..1 in * W o t..i 1 d y o t..i 1 i k e t o «> u t o m a t i c* a 1 1 S;i 
patch the DECnet/E support (YES or NO)? 

DECnet/E patch ln<=( ? *??* NO 

The KMCll is art Intel lisiJent micro- 
p r o c e i=i s o r c o n t r o 1 1 e r w h :i. c h v w h e n 1 o a d e d 
w i t h a p p r o p r i «> t e in i c r o - c o d e s y c a n b e 
used to control various 
p h e r a 1 <•> ♦ H o w in a n w K' M C 1 1 
fiave on this sv;stem (0 to 

KMCll 's ? )KOO>K 

The LP driver can be made to take advan- 
tas-?e of the extended buffer pool rather 
•I, h a n a 1 w a \:{ <i> b u f f e r i 1 "1 <}i c h a v a c t e r o u t p "..i t 
f r o m t h e s m a 1 1 b u f f e r p o o 1 * J h i s w i 1 1 
p a V t i c 1..1 1 a r* 1 y b e n e f i t t b o <•> e s -i^t s t e m s w b i c h 
h a V e a n i n c r e a s e d c o n t e ri t i o ri f o r s ^^.{ <■> t e m 
small buffers* Do wou want the extended 
buffer ins^{ for LP (YES or NO)? 

Extended buffering for LP ? *Y # YES 

The RSTS/E 2700 packasJe emulates the 
operation of the IBM 2780 Model 1 data 

t r' a n «> in i i;* <•> i o n t e r in i i"i a 1 * T b e fa c kasie p e 1 

in its the RSTS/E swstem to communicate 



types 


of peri- 


units 


do you 


16)? 
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with an^* .IBM swi-rbem which supports the) 
device y or another RSTS/E 2780 swstein* 
The 2780 packa<1e is sold and distributed 
as a s e p a r a t e >■> a c M. a <•{ e . 1 1 i s n o t i n a I u d e d 
in the standard RSTS/E kit* jLio wou have 
the 2780 packaj^e Bnd wish to include it 
in this s<:;steiri (YES or NO)? 

2780 support ? #N0* f^O 



The remaininjif questions deal with the 
capacity and features of this RSTS/E 
swsteiri provided at the swstein inanasier's 
option* 

An optional feature of RSTS/E is the 
ability to ve&d and write files which 
are lonsJer than 65535 blocks* Includin*-? 
lar^e file support also reduces file 
creation and access times and makes 
d i s k 1..I p d a t e in o d e <\> i «{ n i f i c a n 1 1 y f 3 s t e r * 
IncludinsJ lari?ie file support will make 
your monitor 2K lar<Jer» and will use 
inore small buffers for each open file. 
Do you want your system to handle lar;,;fe 
files <YES or NO)? 

Larsje files ? #Y •# YES 

With sufficient hardware RSTS/E can han- 
dle UP to 63 simultaneous Jobs* What is 
the maximum number of Jobs (JOBMAX) to 
be used at this installation (1 to 63)? 

Maximum Jobs ? #10# 50 

Small buffers are 16 word blocks in mon- 
itor s to raste that are dynamically allo- 
cated as input and output buffers y file 
r-arameter blocks? etc* Storasie may be 
allocated for 30 to 999 small buffers* 
The recommended minimum is at least 10 
for each possible Job* How many small 
buffers would this installation like to 
have (30 to 999)? 

Small buffers ? :B'500# !500 

Lo<;iical names can be ass i<i{ ned to devices 
on a system wide basis* The assii^nment 
table consists of five words for each 
assisvfnment * Please enter the maximum 
number of system wide lo.<-{ical assi<^n- 
ments that will be in use at any one 
time (5-50)* 

System wide los^icals ? *10# 10 

Y o u c a I'l a d d s p e c i <•} 1 s t a t i s l, i c s ;.J <• j i, h e r i n «{ 
code to the monitor* This code includes 
tables that record Job and disk transfer 
statistics* Would you like to include 
the statistics <-?atherin<J code (YES or 
NO)? 

Monitor statistics ? #N0* NO 
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An opt. ion ail. feature'? of "the RST8/E swstein 
43 ]. :i. o w s t h e f :i. I e f v o c e s ii> o r < F 1 P ) t o u s e 
free buffers y or dedicated i-jections of 
inemor':; (called the extended buffer pooII. ) 
t o «> t o r e d i r e c t a v w i n f o r in a t i o n ♦ T h i <■> 
:i. m p T' o V e <r> t h e <i> p e e d o f d i r e c t o v w p r o c e s s - 
:i. n <■( b v, n o t v e r e a d :i. n <•{ f r e a u e n t .1. *;< <-i c c e «► s e d 
d :L r e c t o r *ij :L i "i -r o r m a t i o n ♦ X f •^.i o u w a n t F X P 
b u f f e f ' i i"i m t \:{ p e Y E S y o iv h e r* w i s e t \:f p e N ♦ 

FIP bufferiniij ? #Y # YES 

An extended version of FIP buffering? is 
3 V a i .1. a b .1. e u ri d e r l"\' B T B / E w h i c:.' h a ;i. :i. o w s .. j o b s 
to specify K on a fiie bw file h;>asisy 
that usey* data files are to be cached in 
t h e e X t e n d e d b u f f e r p o o 1 ♦ 1 h i ■«> c <» c h i n i-i 
is ii'i addition to the FIP directors 
b u f f e r i n <:i t E >i t e i "i d e d d a t a b i..i f f e v i i "i j.;? c a n 
also cache clusters of data? i-ini:!i do vaiBd 
ahead of user data* Xt requires *;;ou to 
allocate at least 2K words to the 
extended buffer pool* Do wou want to 
± n c 1 u d e e x t e n d e d d <•> t a b i..i f f e r i n ai i n *:* o u t^ 
system (YES or ND)? 

Extended data bufferins^J ? #N0# YES 

At the cost of a physically lar<;Jer 
in o ri i t o r y t h e d i s k d t' i v e r* s b n d t h e :i. r 
s i.,i b r o u t i n e s c b n be b u i 1 1 i ri t o a s e p a r «j t e 
in o n i t o r " p h b s e " ♦ 1 f '■j o u w a n t t o in b x i in i z e 
b h e s i z e o f v* o u r s in <ij 1 1 b i..i f f e r* p o o 1 y i:* o u 
s h o u 1 d a n s w e v " Y E S " » B u i 1 d in o n i t o r w i t h 
a separate disk driver phase (YES or NG>? 

Disk driver Phase ? #Y # YES 

An optional feature of RSTS/E allows 
pros-Srains to reduce X/G for overlayini'J by 
B 1 1 B c h :i, ri s? t o s h b v e b b 1 e in e in o r y - r e s i d e n t 
code* If you have at least 124K words of 
in e in o r* *;i y a n d i ri l e n d b o ij s e t h e R M S ■- 1 1 K 
!-\' e ti> i d e n t I... i b r <■» v* \vt y <» ri s w e r ' Y E S ' t 

Resident libraries ? #Y # YES 

The RSTS/E monitor can be made to take 
over <!Jome of the functiorr of tf»e RBX Run 
T i in e S \:t s t e m « I-' r o <■.< r b in s w h i c h n o r in b 1 1 <■.■.{ r i..i I'l 
I..I I "I d e r t h e R S X R u n ••■• 1 i in e S *;* ir> t e m d o ri ' t n e e d 
<iM"iy run tiino'? system y so they can ;i$row to 
3:I.Ky or use the addro:*ss space for a 
r e s i d (? n t 1 i b r a Y' y ♦ T f> ;i. s o p t i o n in a k e «► t h e 
tn <:> n i t a r b b o u t :l. K' 1 a r* si e r* ♦ ][i o *rf o i..i w b i"i t b o 
i n c^ ;i. u d e R S' X d i r e c^ t i v e s i n y o u r in o ri i t o r* 
(YES or NO)? 

RSX directives ? #Y # YES 

If there is sufficient memory available 
on this system y the most frequently used 
non-resident disk handlin;-J code can be 
inadO') resident in order to provide better 
<» y s t e m p e r f o r in b n a e ♦ S h o i..i 1 d t h i s d i s k 
p recess insi be done by resident code (YES 
or NO)? 
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Resident d;i.sk handl ;i.n<i{ ? *Y # ^'^■^ 

The routines to implement the siiri>^>:Le SYS 
c a 1. 1 s 3 1' e ri o r- iyi <;i 1 .1, \.{ n o n -ve s i d e i "i t » v e v & 1 1 
swsteiti perfo nuance can he improved b*;< 
iii3kin*-{ this code residents Do mou want 
the simple SYS call code resident (YES 
or NG)? 

Resident simple SYS calls ? #N0* YES 

Non-resident code is used to delete or 
r e n 3 m e a f i 1 e ♦ 1 f h o i..i w b n t t h & f i 1 e 
delete/ rename code to be resident tvfpe 
" YES"? o t h e r w i s e t '-.-.f p e " HO" * 

Resident file delete/ rename ? #N0# NO 

Non-resident code is used to do loi-finss- 
a 1 1 a c* h e s y b i"i d a s s i <;{ ri a l, t r* i h u t e s ^ 1 f •-.■.{ o i..i 
w <ij fi t t he 1 o .«? i i"i y b 1 1 s c h y b n d b 1 1 r i b u t (^ 
c o d e r e s i d e n t y t *i* p e " Y !:■; S " y e 1 s e b n s w e r 
" NO " ♦ 

Res* losfJ in/attach/attribute ? #N0# YES 

N D n ■- r e s i d e n t c: <:) d e i <•> u s e d t o 1 i s t d i s k 
d i r e c^ t o r i e i-> ( (iJ A T A I... c^ o in m a ri d ) b n d d o 
file lookups* If *:{ou want the directors 
;i. i s t e r and f i 1 e 1 o o k u p c o d e r e s i d e n t y 
t w p e " Y E S " y o t h e r w i s e a n s w e r "NO"* 

Resident catalo««/ lookup ? #N0# YES 



T Y) e f o 1 1 o w i \~\ f^i <s '..i e <•> t i o n s d e b 1 w ;i. t h t h e 
BASIC" PLUS run-time s^ijstem 

Will this software run on a computer 
with a floatinjiJ point processor (YES 
or NO)? 

ppp 'i» >KY * YES 

I"' 1 o a t i n t-i p o i ri t n i.,i m b e r i;; <3 re r e p r* e s e i "i t e d 
internally as two lA-bit words y <;.?ivin<;i 
s e V e n s i j^ n i f i c a i "i t d :i. <.^ i t s * :i; t i ■!•> p o s s :i. b 1 e 
to maintain 17 si;;.?nif icant dis<its bv.{ us™ 
i n <=! 4 w o r d s p e r i "i u m b e v * T h e f o u r w o r' d 
inath packasUvJS also include the scaled 
arithmetic feature* Would this instal- 
lation prefer to use 2 or 4 word math? 

Math precision ? #02* 4 

It is possible to save space in the 
BASIC -PLUS system byj omitting the lo<=«a- 
r' i t h in i c f u n c t i o n s S Q R y E X P y 1... C) v b n d 1... ( •) 1 y 
i f t h e w a r e n o t ri e e d e d ♦ l) a e s t h i s i ri s t a ;i. • ■ 
1 at ion need to compute these functioris 
(YES or N0>? 

Lo«{ functions ? *Y * YES 

It is possible to save space in the 
BASIC- PLUS system by omittin<i« the tri«io- 
ri c:) m e t r i c f u i"i c t i o n s S 1 N y C S y 7' A N y a n d A 1 N y 
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:i.f thew ar<v* not needed* Da os th:i.s J. nst al- 
ia t ion need to compute these functions 
(YES or NO)? 

Tri<;!i functions ? *Y # YES 

Special output f OYMnattlnsJ cbo be done 
i..is:i.n<-{ the "PRINT USING" statement* 
Would this Installation like to have 
this optional feature (YES or NO)? 

Print usinss ? *Y # YES 

BASIC-PLUS permits the user to operate 
o n <■} ri e I'l t i r* e iri s t r i x t..i b i n si J u s t b s i n ^ 1 e 
statement* These statements Bve the 
" M A T " <i> t B t e in e ri t «> « W cj u 1 d t h i s i n s t a 1 1 a ■••• 
tion like to have this optional feature 
(YES or NO)? 

Matrices ? #N0# NO 

A I "I di"' t i o I'i a 1 f e <i! t i..i r e o f B A S 1 C ■•■• P I... U S a 1 !l. o w s 
B V i t h in e t i c.^ o p e r b t i o n s t o b e p e r f o r m e d o n 
numbers represented bw strinsjs* This 
feature can be used to obtain «{r eater 
B c c I..I r <"! c \:i i n b r i Iv h m e 'l i c o p e r b t i o n s ♦ I' o 
^:<ou want strins^ arithmetic (YES or NO)? 

Strinsil arithmetic ? *N0# YES 



The swstem sieneration dialo<^ is finish- 
ed* If you have anw special reauirements 
w t) i c h r e « u i re e d ;i. t i i "i d t fi e <^{ e ri e r^-!: t e d f i 1 e 
C N I"' ;i: (;li * M A C; ( s \:< <•> t e m (.: o n f i i-i u t> a t i o n f i 1 e ) o r^ 
S Y S ( :•) I:;.' N! * C T 1... ( b B t c h c o I"! t r* o 1 f i 1 e ) S:f a u in a '-.■.t 
do it now* When ready twpe "R SYSBAT"* 



R SYSBA" 



S Y S G I:-; H b B t c h p r o c e <■> s i i"i <:i h a s s t b r t e d * 
If anw problems develop durini-5 the h'itatch 
process it may be aborted by typinsii 
"Control/O" * To restart type "R SYSBAT"* 



HELLO 1/2 
Password? 
1 other user is lo«J<^ed in under this account 



SIZE 20 



MOUNT AN-C887A-BC (DECNET PACKAGE) ON A DISK DRIVE 
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READY AND URirrE PROTECT THE DRIVE 

Mount DK J " DECNT A " ~ w r .1 be? :i. ocked 
Unit ? 

♦ASSIGN DKO: DECNTA 

♦R PIP»SAV 

** . )K"=DECNTA J *NSPSUB ♦ OBJ f *NSP ♦ OBJ t *NET ♦ OBJ 

Dismount DKO I 

♦DE ASSIGN DECNTA 

MOUNT AM~2774G--BC <RK06) OR AY--D526G-BC (RK07) ON A DISK DRIME 
READY AND WRITE PROTECT THE DRI>^E 

Mount dm: "SYSGNG" -write locked 
Unit ? :l 

♦ ASSIGN DM:l. J BYSGNG 

♦ASSIGN sysgng: in 

♦R PIP^SAV 

** ♦ *:-IN J fCOMMON ♦ MAC 

*SY : ** ♦ */PR J NOWARN^IN : *SYSLIB ♦ OBJ 

)K3|{^*==INt*0VLHD.0BJ 

** ♦ *:^IN : $L I BR ♦ SA<J » $PATCH ♦ SAV » $PAT ♦ SAM 

** ♦ *"IN t $MINCOP ♦ BAS 

Jif'C 

♦ R PIP^SA"^ 

*TBL ♦ OBJ y TTDINT ♦ OBJ yTTDVR ♦ OBJ/DE t NOWARN 

>KTBL a-ST 9 TTDINT . LST ? TTD^^R ♦ LST/DE I NOWARN 

*RSTS ♦ SAM y TER ♦ SAM f DSK ♦ SAM/DE J NOWARN 

)KEMT ♦ SAM ? FIP ♦ SAM y RSX ♦ SAM y OMR ♦ SAM/DE J NOWARN 

>KRSTS . MAP y TER ♦ MAP y DSK ♦ MAP/DE : NOWARN 

5KEMT ♦ MAP y FIP ♦ MAP y RSX ♦ MAP y OMR ♦ MAP/DE t NOWARN 

)KRSTS ♦ STB y TER ♦ STB y DSK ♦ STB/DE t NOWARN 

*EMT ♦ STB y FIP ♦ STB y RSX ♦ STB y OMR ♦ STB/DE t NOWARN 

)KNSP ♦ SAM y TRN ♦ SAM y XMDMR . SAM y R J2780 . SAM/DE I NOWARN 

*NSP ♦ MAP y TRN ♦ MAP y XMDMR ♦ MAP y R J2780 ♦ MAP/DE J NOWARN 

*NSP . STB y TRN ♦ STB y XMDMR ♦ STB y R J27B0 ♦ STB/DE t NOWARN 

jK-'C 

♦R MACRO ♦SAM 

*TTDMRy TTDMR/C=-IN t ^COMMON y *KERNEI... y DK t CONFIG y IN 5 *CHECK y $KBDEF y $TTDMR 

ERRORS detected: 

*'-^C 

♦R MACRO ♦SAM 

*TTDINT y TTDINT/C===IN : ^COMMON y ^KERNEL y DK I CONFIG y IN : *CHECK y *KBDEF y HiTTDINT 

ERRORS detected: 

♦R MACRO ♦SAM 

HcTBL y TBL/C"-- 1 N : fCOMMON y *KERNEL y DK : CONF I G y I N : $CHECK y il>TBL 

ERRORS detected: 

)K"C 

♦R LINK ♦SAM 

>|cRSTS/Z y RSTS/A/W » RSTS--='TBI.,. y *ERR ♦ STB/X/B : 0/E : #37200/U : #:I.OOO/I/C 

*NSPSUB/C 

jkttdint/c 
*in:*rsts 
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li:: X t & ri d B e c t i a n ? M D R B U F' 
R o I..I i-i d s e c t i o n ? M R- B IJ I- 
L:i.brarw search? SYDLRG 
I... ;i. b r 3 r w «> e a r c^ ^^ ? B U i-" E X T 
1... ;i. b V a v \.{ ii> e a r c !■) ? I... I-' D "v* R X 
Library search? 

«R LINK » SAM 

)KDSK/Z y DSK/A/W y DSK-^=;i:N J $IiSK » DK t RSTS ♦ STB/X/B i *.l 17000/U J #:1000/I/C 

)i<:i:NJ*R8TS 

R o 1..I i"i d s e c t ;i. o n ? B S K" I-' A J 
I. i b r <3 r y s e a r c h ? B K S E E K 
I... :i. b r <•» r s-.! s e a r' c h ? B M S H:! E K 
L i b r <•) r •■.■.{ s e -^s r c h ? B T^ S I;:! E K 
1... i b r a r y s e a r> c h ? B B S E E K 
1... :i. b r «5 r •■.■.} s e a r c h ? 

*R LINK.BAV 

>KTER/Z !- TER/ A/W s- TER-^" I N J $TER y BK t R8TB ♦ STB/X/B : * :1. :l 7000/U { # :l. 000/ 1 /C 

^TTBVR/C 

*:i:nj$rsts 

I'i: o u n d n; e c t i o n ? T E R P A T 
I... i b r a r v; s e ifj r* c h ? T T S Y S T 
Library search? 

♦ R LiNhwSAV 

)KXMBMR/Z y XMBMR/A/W y XMBMR-^KN tXMP i* BK t RSTS ♦ STB/X/B t *! :l. 7000/U J #:l.OOO/I/C 

)j<;i:nj$rsts 

Round section? XMBPAT 
L i b r a r y s e a r c ^) ? X M B M 1^^ M 
Library search? 

«R l:i:nk*sav 

JKEMT/Z !- EMT/A/W y EMT===.TN t *EMT y BK ? RSTS * STB/X/B t #:l. 17000/U t *.tOOO/l/C 

R o I..I n d s e C' t i o ii ? K! M T P A T 
L i b r s x' y s e b r c h ? 1... !i; B 
Library search? 

»R l:i:nk*sam 

>«F I P/Z y F I P/A/W y F 1 P'- 1 N t i!>F ii: PLRG y BK t RSTS ♦ STB/X/B J *1 1 7000/U : f 1 000/ 1 /C 

>!<:!;N?iHRSTS 

R o I..I n d s e <;.' "Iv i o n ? F ;i.' P P A T 

L i b V* & r H <!> e <» r c;^ i""i ? 1-' L 

1... i b r <:J r v* <■> e a r^ c^ hi ? U U 

1... i b r* (••} r h is e b r <:* h ? S N B 

i... i b r B r *;J <•> e b r c h ? L I N 

L i b T' B r \;< s e a r^ c? h ? B 1 R 

Libra rvj search? 

.R l:i;nk,.sam 

*RSX/Z y RSX/A/W !> RSX="::I;N J $RSX y BK { EMT ♦ STB/X/B t %% :I.7000/U : #1000/C 

>{<:i:NtiiiRSTS 

R o I..I i"i d <•> e c t i a n ? R S X P A J 

♦R LINK. SAM 

)i<NSP/Z y NSP/A/W » NSP=='-NSP y FIP . STB/X/B J #1. :I.7000/U : *1.000 

R o IJ n d s e c t i o ri 'i* N S I-' I-' A T 

>k"m:: 
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*ovR/z » ovR/A/w f dvR"":i:n : *o>v/rlrg ? dk : nsp ♦ stb/x/b t #iooo/c 

*NET/C 
*;CNJ*RSTS 



♦ R S3:LUS»£5AV 

*53YO : CO » .1. riRSTBV? . SIL f TT : ==RSTB y TER/M » DSK/M y EMT/M y F.TP/M/C 

*RBX/M/C 

*XMDVR/M/C 

*NSP/M/C 

*OVR/M/C 

*:i:N:*ODTy$DEI-ALT 

n.i. recto rii* of BIL RSTSV7 ♦ Sin... on 22 -Apt ■"79 at 07J;I.5 PM 



Name 



I dent 



Load 



Si;Ke Transfer To tail. 



RSTS 


07 ♦ 007 


000000 


130000 


000001 


22K 


TER 


07 ♦ 007 


120000 


016000 


000001 


26K 


nsK 


07*007 


120000 


010000 


000001 


28K 


EMT 


07*007 


120000 


020000 


000001 


32K 


PIP 


07*007 


120000 


031000 


000001 


38K 


RSX 


07*007 


120000 


007000 


000001 


40K 


XMP 


07*007 


120000 


ooaooo 


000001 


41K 


NSP 


OAC*00 


120000 


020000 


000001 


45K 


OVR 


07*007 


002000 


100000 


000001 


6 IK 


ODT 


07*007 


140000 


012520 


142522 


6AK 


liiEFALT 


07*007 


001000 


002000 


000001 


64K 



Resident irion:i,tor size is 4SK (with 501 small h-.H..if fers) 

128 small buffer^s can be mided to this s^:<stem (629 total) 

16 small buffers can be added without a size chan<-?e (517 total) 



*RUN l:i:br*ba<; 

*BY i $SYBL1B==^^BY : $SY8L1B y BK J OVLHD/U 

*r pip* bam 

*basic * bav y basic * btb/be t no warn 

*R L1NK*SA>.' 

)KBAS1C/Z y BABXC/A/W y BAB IC^:" IN J *RTB y BK J *ERR * BTB/X/H t #177776/U J #4000/C 

*INJ*MA4F/C 

*INJiiiXL4F/C 

*INJ$XT4F/C 

*INJ*BF/C 

*in:$io/c 

*INJ$PU/C 

*INJ*SN/C 

*INt*VE 

R o i.,i h d s e c t i o i "i ? I-' A 

*'T 

*R SII...UB*BAV 

*BAS I C . RTS y TT t ==-B AB I C 

Bl recto rw of BIL BASIC *RTB on 22- -Apr"" 7 9 at 07 J 15 PM 

Name I dent Load Size Transfer Total 

BASIC 07*007 100000 077776 000001 16K 
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*DEA<i>s:i:GN :i:n 



Dismount DM:1.? 

♦DE ASSIGN SYSGNG 

<.R p;i:f%sav 

>KS Yo 1 1: V 1 ::i t * t/mnw. 1 1 6 » ==^:b as :i: c ♦ rts 

>!<BAS:i:C,RTS/DE 

«R LOGOUT 

Confirm* Y 

Saved a;!. .1 disk files? 3928 blocks in use 

Job 2 User :l. i'2 loi-isied off KB:I. at 22--Apr 79 07J:L5 PM 

:l. other user stil i lof'iiHed in under this account 

S^^istem RSTS V7*0-07 RSTS/E SYSGEN 

R !..( i"i t i m e w a s 6 in i n u t e s y 1 1 * 2 s e c o n d s 

E 1 B i"' s e d t i m e w b s 1 1 m i i"i u t e s 

Good evenin.<vS 



B a t c h s.i o b c:.' o ivi f I e t e d <■ 

,R ut;i:l.ty 

>KNO LOGINS 
Jf; SHU TUP 

Warniniii:! t^ DB2* is duai ported? proceed with caution! 

Warnin;>5 ** DB:I. ♦ is duail. ported^ proceed with caution! 

RSTS V7*0-07 RSTS/E SYSGEN <DRO) 

Option J INSTALL 

Si I <SYSGEN>? 

T «:f p B t h e f i I e ri b iri e o f t h e iri o n i t o r s b v e i iri b <;i e I i b r a r* <r.{ ♦ 

Directors of all »SIL files in i;:0y1.::i? 

SYSGEN ♦SIL 
RSTSU7»SIL 

Si I <SYSGEN>? RSTSU7 

Option? DEF-AULT 

No defaults are currently set in RSTSM7*SII... 

You currently have? JOB MAX ■■■■'■■ 50 y SWAP MAX ■■"^ :l.6K* 

JOB MAX or SWAP MAX chani^Ses? 
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JOB MAX or SWAP MAX may be? c h an s^eci as fo;i.:i.owsJ 

:l. ) ,J B MAX iti a "rj n e v e t' b e ?,•! r e a t © r t h a ri 5 v w h :i. c h i s t h e .J o b in b >i i m u in 
SFGJcif led at system ^iieneration t;i.me» 

2 ) S W A F' M A X n w h :i. <:^ h i b e x p r e <;; s e d :i. ri K o f in e m o r '■.■.( < 1 1< •"• 1 <> 2 4 wo r d s ) y m «j ;:* 
n&<^GV bo i^roater than 3:1. (K) or Loss than 8 <!<)♦ 

3 ) lii: i-t c h o f thB f o 1.1 1' >■••' o s s :i. b I e s w <» p f .i. .1. o s c a n h o I d N ,..i o b sv w f i o r^ o 

N "" i::S:i.zo of swap f:i, :i.e (:i.n blocks)::! / CSWAP MAX (K) * 4::i 
truncated to an inte?.-Jer« The sum of the N's for the four swap 
f i I e s d e t e r in :i. n e <■> t h e n i. j in b e r^ o f J o b s w ft :i. ch m a i:^ :i. o <:■!■, o ri » T h :i. s' ri i..i m b e r 
m B y b e :i. n c r' e a <■> e d <:) n :i. ;i. n e b y <•> d d :i. ri <■« <•> w ;is p f :i. :i. e s < i.,i p t o a in ;■> ;•;• i in u m o f 
An :i.nc.1.ud:i.n<-,« SWAP * SYS) c but may never cKceed the JOB MAX specified 
a t s t a r t - u p t :i. in e ♦ 

4) The one required fi:i,e? SWAP.SYSy must be at :ieast LSWAP MAX * 8::i 
b :i o c k s :i. o ri <:i v s o t i\ a t i t <:.' a n h o :i. d t w o J o b s . 

Type 'YES' to chan*=!e JOB MAX or SWAP MAX* Type 'NO' to :i.eave the 
inaMima as they stand* Any chan<^es? y^s 

New JOB MAX? 

Type 'NO' if you don't want to chanj^ie the current JOB MAX* 
To enter a new JOB MAXy type a number between :i. and 50* 

New JOB MAX? 50 

New SWAP MAX? 

Type 'NO' if you don't want to chan<:;?e the current SWAP MAX* 
To enter a new SWAP MAX» type a number between 8 and 3:1. (K)* 

New SWAP MAX? 31 

You current.1.y have? JOB MAX ■■■■■■■■ 50? SWAP MAX '■'' 3:1. K* 

JOB MAX or SWAP MAX chans^es? NO 

R u ri T i in e S y s t e in ? 

Specify the name of the Run Time System to be used as the system 
default* The named Fi;un Time System must exist on the system disk 
i ri B c c^ o t..i ri t \:. v .1, ::i w i t h e x t e ri s i o n ' * R T S ' * 

D i r e c to r '■j o f a :L 3. v a 1 i d t' u ri t i m e s s-j <:> t e m s ♦ 

RT:L:l. ♦RTS 
BASIC *RTS 

Name of default Run Time System? BASIC 

E r r o r m e s s a «i e f i. 1 e ? 

8 p e c i f \:S t h e n a in e o f a f i 1 e :i. ri I," v 1 '.i w i t h e x t e ri s i o ri ' ♦ lii: R R ' 
which contains the Ia'STS/E error inessa<;<e text* 

.D i rector S:i o f v a 1 i d e r r o r in e s s a .<■.! e f i 1 e ii; t 

ERR ♦ERR 

N ci m e o f e r* i^ o r in e s s a <}i e f i :i. e ? i-;; j^- f;; 

:i: n s t a 1 :i. a t i o n n a in e ? 

1:1 n t e r t h e .i ri s t a il. 1 a t :i. o n i"i a iri e a s a s t t- ;i. n ?;.« o f u p t a 1 5 c har a c t e rs <, 
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New irist3 nation name? Lsr^e Swstem 
Memory 3I location tablet 

ok: 00000000 - 00263777 < 4510 : exec 

4SKt 00264000 - 003A3777 ( %6K) t RTS (BASIC) 
61KJ 00364000 - 03777777 < 4S1K) J USER 
512K: 04000000 •" End : NXM 

You currently have selected data cachini'Jy 
be sure to allocate at least 2K of XBUF 

Table suboption? 

Val:i.d table suboptions are* 

LIST List the current memory allocation table 

PARITY List the parity memory conf i<!Juration 

RESET Let RSTS reset the default memory conf i;-{uration 

LOCK Lock out some memory 

UNLOCK Unlock some locked memory 

RTS Move the Run Time System to a special location 

MAP Specify a portion of XBUF to be m&r-'Ped with UMR's 

XBUF Allocate extended buffer space for disk/messa?;ie each in sf 

EXIT (or <LF>) when you Bve satisfied with the table 

n 1 M t h e f i r b t t w o c* h <•> r' <■> c t e r <■> n e e d b e t y p e d 

Table suboption? XBUF 

Extended buffer address ran«{e is? 

I-:.' n t e r t h e a d d r e i!> s e s o f t h e f i r s t m n d ]. a s t :L K in e in o r «:* s e c t i o i"i s 

to be used for disk block cachinsiJ and larsJe messas^e send/ receive* 

Extendo^d buffer address rans^e is? 61K'^B0 

T a b 1 e <"> u b o p t i o n ? I- ■'• B f ' 

M e m o v::{ a 1 1 o c a t i o ri t a b 1 e t 

OK J 00000000 •••• 00263777 ( 4;i!iK) t EXEC 

45Kt 00264000 ••• 00363777 ( 16K) i RTS (BASIC) 

6:lKJ 00364000 •• 01063777 ( BOK) t XBUF 

lAlKt 01064000 ••" 03777777 ( 371K) t USER 

512Kt 04000000 ■••• End t NXM 

T' a b 1 e s u b o p t i o n ? '::■ X 1 T 

Cache cluster size <4>? 

Choose the number of 512 byte blocks to be treated 
a IS a u n i t r o r p u r p o <i; e s a f d i s k d a t a c a c h i n <:-i ♦ I... e fH a 1 
values are 1» 2.9 4y and 8* 

Cache cluster size <4>? B 

You currently have crash dump disabled* 

Crash dump? 

Type 'YES' to enable crash dump at startup time* 
T' V* p e 'NO' t o d i s a b 1 e c r^ a s h d u m p * 

Enable crash dump? YES 
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Masitapo labc»:i. l:i.i"iJ^ default <rione)>? 

Type 'ANB:i:' to select ANSI standard masjtape label. J. ins:! for swstein default* 
Twpe 'DOS' to select DOS forMnat mad tape labelliriK? for system default* 

M a Id t a p e 1 a b e 1 1 :i. I'l f^ d e f a i..i 1 1 < ri o n e > ? i\ Q s 

Preferred clock <P :1.0<)>? 

Choose the clock whlchy if avail able c should be used durinsf t:i.meshar:ln<.=s» 
l" w p e ' L ' t o u s e t h e K W 1 1 - 1... 1 :i. n e f r e g ij e n c •■.■.{ c I o c k « 
Tvjpe 'P' to use the KWll-P programmable clock* 
Type <I„.F> for no chan?-5e« 

Preferred clock <P 100>? P 

I i"i t e r r u p t f r e « "..i e i"i c sj ? 

Type 'LINE' to use the KW11--P at AC line freauency* 
Type a multiple of 50 between 50 and 1000 to use the 
KU)11--P crystal clock at the specified interrupt frequency* 

I I "I t e r r^ u p t f r e a u e n c ^i* ? 1 

D ate forma t < A L I"' H A B lii: I' 1 C > ? 

Type 'A' or 'N' to choose the? format for the system date* 

Type 'A 1... P \-\ A B I:-: T 1 C ' f o v a 1 p h a b e t i c d a t e < e * <■? * 3 1 - D e c' - 76) <^ 

T y p e ' N U M E R 1 C ' f o r- i "i u in e r i c d a t e ( e . ;H * 7 6 * 1 2 * 3 i ) * 

Type <LF> for no change* 

Date format <ALPHABET1C>? A 

T i m e f o r m a t ••:: AM/ P M > ? 

Type 'AM' or '24' to choose the format for the system time* 
T \:{ p e 'AM/ 1"' M ' f o t- AM/ i-' M f o r in a t t i me ( e « f-i * 01 1 3 I"' M ) * 
T' y p e ' 2 4 - H LJ K' ' f o r i"i u in e r i c t i m e ( e * <?i * ;l. 3 1 3 ) . 
Type <LF> for no chan<i«e* 

Time format <AM/PM>? AM 

I-" o w e r' f B i 1 d e 1 a sj < 1 > ? 

When power is restored after a power failure? RSTB/E will 
d e 1 a y t h e r' e c o v e r \:t f o r 1 t o 3 s e c o n d s t o a 1 1 o w a 1 1 
devices to become ready* Specify the number of seconds 
y o u w a ri t t o d e 1 a y » 

Power fail delay <1>? 300 

Option J START 

You currently have J JOB MAX ^■■■■' '50 v SWAP MAX ■■-■■ 3 IK* 

JOB MAX or SWAP MAX chanties? 

JOB MAX or SWAP MAX may be chan<^ed as follows? 

:l. ) JOB MAX may n<sver be «$r eater than 50 j which is the Job maximum 
specified at system iifeneration time* 

2 ) SWAP M A X y w h i c h i s e ;■{ p r e s s e d i ri l< o f in e m o r \:t ( 1 K ■■■■■■ 1 2 A w o r d s ) ? m <:j sj 
ni'!)vi:^r be ?/ir eater than 31 (K) or less than 8 (lO* 

3) Each of the four possible swap files can hold N Jobsi* where 

' N ■■■■■■■■ i:;Si^e of swap file (in blocks):! / LSWAP MAX (K) M Al 
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truncated to an integer* The sum of the N's far the four swap 
f:i. les deterirdnes the number of Jobs which maw lod on. This number 
may be increased on line bw add in<^ swap files <up to a maximum of 
4f includinsi SWAP»BYS)r but may never exceed the JOB MAX specified 
at start™ UP time* 

4) The one required filey SWAP* SYS r must be at least CSWAP MAX * 811 
blocks lon«?r so that it can hold two Jobs* 

Type 'YES' to chansJe JOB MAX or SWAP MAX* Type 'NO' to leave the 
maxima as they stand* Any chan)=fes? NO 

A n y m e m o r y a 1 1 o c a t i o n c h a n si e s ? 

If you wish to specify a certain portion of memory as unavailable to 
RSTS or as dedicated buffer spacer or if you wish to locate the Run Time 
S y s t e in a t s o in e s p e (.: i <•> 1 a d d r e <•> s < e * *■{ * i n MOB m e m o r »:0 » a n s w e t« 'YES'* To 
leave the memory allocation unchani^ed from the last specified table y 
answer 'NO ' * 

Any memory allocation chan«<es? NO 

Y o u c u r r e n 1 1 !:? h b v e c r a <•► h d u in p e i"i a b 1 e d » 

Crash dump? 

T \:f p e ' Y lii; S ' t o e n a b 1 e c. r a s h d u in p a t s t a r t u p t i m e ♦ 
Type 'NO' to disable crash dump* 

Enable crash dump? YES 

22-Apr--79? 

Enter date as 'DAY-MONTH-YEAR' (e*"?*? 31"DEC~76) 

a V a s ' Y E A R ♦ M N T H * D A Y ' ( e * d * y 76, i 2 * 3 :l, ) ? 2 2 • ••• A P R •-• 7 9 

07 J 36 PM? 

Enter time as 'HOUR J MINUTES AM' or 'HOUR J: MINUTES PM ' (e*pJ* 1J15 PM) 

or in 24-hour format as 'HOUR {MINUTES' (e*<-{* 13J:l.5) ? ?t36 PM 

DBO* disabled - unit not present 

:i. device disabled 

?Can't find file or account 
? I"' r <;) <-i V a in 1 o «► t - S o r r •■.-.i 

Ready 

MOUNT !(:!MOJSYSI..,;l,G/RO 

Ready 

RUN dmo{$bu;i:ij:i 

BUILD ^7*0-07 RSTS k^7*0-07 Lars^Je System 

System Build <No> ? YES 

Source Input Device <DMOt> ? DM0? 

Library Output Device <SY{> ? SYt 

Tar<;5et System Device <SYOJ> ? SYOJ 

I., i b V B r vi A c c o u i"i t < L .1. r 2 "i > ? \". 1 y 2 "i 

>X * * C o p \:i i n <•{ f i 1 e D M 1 1:: :l. y 2 :;i B U I L D * C T L t o B 1... D 1 * T M I"' >ioK)K 

I... o c i:i t e 1 o <-i i c a 1 ' 1... B { ' o n <: s Y 1 1 1 y ;i. ::i > ? 8 Y t L 1 y 1 :i. ::i 

Z C a n ' t f i n d f i 1 e o v a c c o u i-i t ••■• S Y 1 1:; :l. y .1. :i. ,:i 

Attempt to create account SY J L:!. y :l.i:i <No>? YES 

A a c o u n t S Y * I" .1. y :l. :l. !.'l c r e a t e d w i t h \:{ o u v p a s s w o r d 

I" u ri c t :i. o ri ( B u :i. 1 d / 1-" a t c: h y I-' a t c h y B u i 1 d ) <B u i :i. d / P a t a h > ? B U 1 1... D 

r^jn-Time System <BAS1C > ? BASIC 
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Locate ERROR Packasje on <SY: i:i !'2:i> ? 3Y tCl ,81 

XCan't find file or account, ~ SYJCli-B] 
Attempt to create account SYJClyS:] <No>? YES 
Account BYUJli^fn created with wour password 
Additional Control File is <None> ? BPLER 

*** Cop^rfind file »M0 J CI. y2:iSPLER»CTL. to KLDOl ,TMP *** 

Locate SPOOLING Packa«-iie on <SYtLl»2:]> ? SYt i:::L y250::i 

% C a n ' t f i ri d f i 1 e o r* a c c o u n t - S Y t C 1 » 2 1!5 13 
A 1 1 e in p t to c r e a t e a c c o u i "i t S Y t C; 1 c 2 5 : J < N o > ? Y I:- S 
Account 8Y?i:iy2S03 created with wour password 
A d d i t i o n a 1 C; o n t r o 1 F i 1 e i s < N o n e > ? B :i: (3 P R G 

*** Copwins? file LiMO J III y2:iB.XGPRG.CTL to BLDO.l/rMP *** 

Additional Control File is <None> ? BACKUP 

*** Copwinj.^ file DMOt CI »2JBACKUP,CTL to BLDOl/rMP *** 

Locate BACKUP Packa£<e on <SYJi:i»2:i> ? SY t LM. s- 99::i 

%Can't find file or account - SYJLl»99:i 
A 1 1 e in p t t o c r e «> t e a c c o i..i n t S Y J E: 1 » 9 9 3 < Ho>?' Y E S 
Account 8Y:i:iy99:] created with wour password 
Additional Control File is <None> ? DE'v'TST 

^^t Copwins.? file DM0 J ri »2:iDEVT8T»CTL to BLIi01»TMP *** 

Locate DEMIST PackasJe on <SY:i:iy2:]> ? SY n::l. s/ 4411 

%Can't find file or account - SY J n 1-44:1 
Attempt to create account B'ftl.lvAAl <No>? YES 
A c c o u n t S Y J i: 1. y 4 4 :] ere a t e d w i t h y o u r p a s s w o r d 
Additional Control File is <None> ? 
COMPILE SYn:iy2:JBUILD 
OL D DM0 : C 1 y 2 :J LOG 1 N f B AS 
COMP 1 LE S YO n: 1 y 2 ;] LOG I N<232> 
OLD DM0?Cly23ATPK*BAS 

COMPILE sy:i:i»2:iatpk 

RUN SYJLM. y2:.1ATPK 
BLD01»rMP/RTSJi:0yi:3BASIC*RTS/L0G/DEL 

Readvj 

Ready 

Ready 

Ready 

Ready 

Ready 

ATPK V7,0-07 RSTS V7.0-07 Larde System 

Ready 

ASSIGN SYOJSYSDSK 
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Reach:* 

ASSIGN SYt SYSTEM 

Readi:i 

ASSIGN i:::i, y2::i 

Read^iii 

ASSIGN IiMOM:NI"'UT 

Readv* 



! 1 1 * :=!< 5K * >!< 5}! ** B U :i: I... D <■ C T I... - S TAN » A R iCi i.. I B R A R Y I-' 1=^; C) (•} F^; A M S 

! G o f \:i r i <:i h t < C ) :l. 9 7 9 'o \:{ D :i. ?.■.« :i. t b 1 E. a i..i :i. p rn e i"i t C o r p o y <s t :i. o i"i y M a »:* n a vdr M <3 s <•> 



SCALE 
Read^:* 

L i\ n M J i: :i. ? 2 ;:i c p a 'T' c i-u b a s 

Ready 

COMPILE SYJi:;iy2:;iCPATCH 

Ready 

SCALE 

Ready 

OLD DMOn::;l. y2::iAUT0ED»BAS 

R^BdS:} 

COMPILE SYJi;::i. y2::iAUTaED 

Ready 

SCALE 

Ready 

1... B B M 1 1:; ;t. 9 2 1 B U 1 L B <• B A S 

Ready 

COMPILE SYJ!::i!'2:;iBUILB 

Ready 

SCAi.,.E 

Ready 

1... B B M t L 1 V 2 :;i A ■}■■ F' K . B A S 



System Generation Examples E-99 



COMPILE SYJn. ?2::iATPK 

SCM...E 
Beach:* 

OLD »hoii:::i.!'2::ilog:[N.bas 

Readw 

c M I"' :i: I... i;:: s y o 1 1;: ;i. ^ 2 1 1... g :i: n < 2 3 2 :> 

Rwadw 

SCAi.,.E 
Readw 

1... D i(:i M 1 1: ;i. V 2 ::i 1... g u t ♦ b a s 

ReadH 

COMPILE SYO J 1: :l. y 2::iL0G0UT<232> 

Readw 

SCALE 
Readw 

OLD DMon:::i. y2;:iPATCPY.BA$;5 
COMPILE SYJi:::i. .2::iPATCPY 

Read^;; 

SCALE 

Reads 

OLD DMOJi:::l. y2::iPBUILD*BAB 

\"n-XBd'nf 

COMPILE SYJi:::l. !'2::iPBUILD 

Readw 

SCALE 

Readi:! 

i... D B M 1 1 1 ? 2 ::i U 1 1 1... T Y * B A S 

Read*.:* 

COMPILE SYo;i:::i. :'2::iuTiLTY 
E-lOO System Generation Examples 



SCALE 

OLD DMon:::U2::Li;N:i:T *bas 

Ready 

coHPiLE SYon:::i. y2:];i:N:i:T 

SCALE 

OLD DHOn:::l. !'2:;!SHUTUP»BAS 
Readw 

COMPILE SYOSi:::!, !'2::iBHUTUP 

<:>CAI...£ 
Ready 

1... D D M 1 1:: :!. V 2 ::i i::: r r b l lu b a <;> 

Ready 

COMPILE SYn;::l. vBlJERRBLD 

Reads^i 

RUN SYn;::l. s'BIIERRBLD 

ERRBLD V 7.0 •••■07 RSTB '^7. 0-0 7 Larrfe Bys'tem 

R.BBd'-.-.i 

SCALE 
Ready 

i... D D M 1 1: :i. y 2 ::i e r r i n 'if . b a s 

Ready 

COMPILE BYn:::l. yB^IERRINT 

Ready 

SCALE 
Ready 

1... D D M 1 1: :i. V 2 ::i i::: i-^ R c p y « b a b 

R<!'!Bd'::{ 
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COMPILE SYtt::!. s-BiilERRCPY 

SCALE 
Re>ady 

OLD i:iMOJi:;i. y2::iD:i;RECT,]BAS 

C M F 1 L E S Y i i: :l. 9 2 J Ii I R E C "T" < 2 3 2 > 
Recjdw 

SCALE 

Ready 

OLD DMO J i: ;l. , 2::iTTYSET ♦ BAS 

Ready 

COM I"' 1 L E s Y 1 1:: :i. s^ 2 ::rrT y s ih: y < 2 3 2 > 

F\'eady 

SCAI..E 

Ready 

OLD DM0 1 1:: :l. y 2 1 SYST AT ♦ DAS 

Ready 

c M p 1 1... E s Y J i: J. V 2 :;i s y s 'I' a t < 232 > 

Ready 

SCALE 
Fileady 

OLD DMOJi:::i, y2;iED:i:T .bas 

Ready 

COMF^' 1 LE s Y J 1:: :l. y 2 :\ ED I ■r<40> 

F\'eady 

SCALE 

Ready 

L D D M 1 1:; :l. y 2 :;i E D 1 1 C H » B A S 

Read'-.-.t 

COMF^' I LE SY t \: 1 y 2 :i ED 1 TCFI<40> 

Reavjy 
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SCALE 

Ready 

1... D B M i \: 1 y 2 1 {• R R D I S ♦ B A S 

R©c>dw 

c M I"' :i: I... IE s Y J i: :i. » b ::i e r r d i b 

Rwadw 

SCAI...E 

Ready 

OLD DM0 1 1: 3. y 2::iERRDET ♦ BAS 

Re<3dy 

COMP I L.E BY J i: :l. V B :i ERRDET 

Ready 

BCALE 
Readv* 

1... D D M J i:: J. y 2 ::i a n a l y b ♦ b a b 

Ready 

COMP :i; LE BY : i:: :i. ? a ::! an al ys 

Ready 

SCALE 
Ready 

1... D 1.1 M 1 1: :i. !- 2 ::i A N A i... y :i. ♦ b a b 

Ready 

c M I"' :i: I... lii; s y j i: :i. v 8 ::i a n a i... y :i. 

Ready 

BCALE 
Ready 

OLD DMOu::i. i'2;:iODT »bab 

Ready 

comp:i:le BYJi::;iy2::iODT 

Ready 

BCALE 
Ready 
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(,) I... n i:i M : r. :i. y 2 :i r e a c j * b a b 

RBBChti 

COMPILE SYJi:::l. y2::iREACT 
Raarhi 

SCALE 

Ready 

OLD DM0 1 1: 1 V 2::iRE0RDR * BAS 

R&Bchf 

C M P I L E B Y J t: :l y 2 ;:i R E 1^ B R 

ReadH 

SCALE 

Readw 

L 1:1 D M : i: .1. f 2 1 D S l< I N T . B A S 

Rosdw 

COMPILE SY : 1:: :i. v 2::iDSK:i:Nr 

Resdw 

SCALE 
Ready 

OLD BMO : r: 1 y 2 ::i umount ♦ b as 

R(^adH 

C M I"' :i: 1... E SYtl 1 y 2 ill U M U N J < 2 ;3 2 > 

Readw 

SCALE 
Ready 

OLD BMO :i:::u 2:3 COPY ♦bas 

Ready 

C M !"• X 1... 1;;: S Y J 1:: :l y 2 :i C 1"' Y ■=:: A :> 

Ready 

SCALE 

Ready 

1... 1:1 D M 1 1:: .1. y 2 :i \- 1 1... C M » B A S 

Ready 
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c; c) M !-• :i: i... e. b y u; :i. v 2 :\ f 1 l c m < a > 

Readw 
SCALE 

OI...D DM0 1 1;: :i. !- 2 ::i quolst ♦ b as 

Rb a<:ht 

c Q M I"' 1 1... E s Y ; 1:: ;i. v2.:m u 1... s 1 < 232 > 

Reachi 

SCALE () 
Readw 

a L D » M 1 1: 1 f 2 ::i m n e y « b a s 

Re;;}dy 

c D M I"' :i: L ii- s Y 1 1:: ;i. v 2 ::i m n li- y < 4 > 

l'i;eadw 

SCAI.,.E 
Readw 

1... D ici M 1 1: :i, V 2 ::i r 1 p e ♦ b a s 

Readsj 

c M I"" 1 1... i:;: s y j i:: 1 v 2 ::i (3 1^;; ;i: i-* e < 232 > 

ReBrhi 

SCALE 
Rwadw 

OLD DMOn:::l. i'2:.ITALK «BAS 
Ready 

C0MP:I:LE by 1 1:: :l. * 2:^■ALK<232> 
Re<•|}dw 

SCALE 
Ready 

c) 1... 1:1 D M 1 1:: :i. V 2 ::i i-' 1... 1;:: a s 1^; » b a s 

Readw 

c M 1=' X L lii: s Y i \: 1 v 2 ::i p l e a s e < 2 3 2 : 

Ready 
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scalie: 

OLD DM0 : i: .1. V 2 :;i :i: nuse ♦ dab 

Ready 

COMP I LE 8 Y U; :l, c 2 :i I NUSE<40> 

Readw 

SCALE 

OLD DM0 til 9 2 ::i s w j; tch * das 

Ready 

COMP:i:LE SYJI:;!. y2:iSWITCH<232:: 

Ready 



RUN 8Yii:;i. >'2:ip;i:p,sav 

)KSY 1 1: .1. 9 2 ::i onlcln * sam/rtb ? rt 1 1 ■■■■■■■'[.mo 1 1: : 

Ready 



■ 2 ;:i ONLCLN ♦SAiv> 



RUN SYJi:iy2:3PIP»SAV 

*SY 1 1: :i. 9 2:jnot;i:ce » txt<40> 

>KSY : i: 1. 1- 23HELP » TXT<40> 
>icSY J i: :l. y 2 ::i start ♦ TMR^'^iRD t 
(?SY0Ji:iy2:iRTS«CMD 
{3SY0n::.1. y2JTTY*CMD 
y0SPOOL«CMDi::L!'2:J 

(3SYou::u2:;iccL*CMD 

DETACH 



/PR i NOWARN^^-DMO { L"! .1. y 2 ll NOTICE » TXT/ AS/NO 
/PR ; NOWARN:^^:DMO 1 1: :l. ? 2::iHELP ♦ TXT/ AS/NO 



LOGIN KBOJ i.':i.2:] 












FORCE KBOJ RUN SYU::U 


2::iUTILTY 










FORCE KBOt REMO»^E LOG 


i:CAL LB 










FORCE KBOJ ADD LOGIC A 


... SYti::;l. y;l.;l.;;iLB 










FORCE KBOt EXIT 












FORCE KBOJ BYE/F 












ATTACH 












FORCE KBOJ RUN SYJi::;L> 


U:! ERR I NT 










FORCE KBOJ .1.00 












FORCE KBOJ NO 












LOGINS 












SEND RSTS/E IS NOW ON 


THE AIR.,* 










FND 












H<SYon:::iy2:iSTART .ctl 


/PRJNOWARN^ 


:SYJi:::i. y2;:i 


START 


TMP/AS 




>KSYJi::Ly2:3START ♦TMP 


/DE J NO WARN 










>KSYon::i. !'2::iTTY ,cmd 


/PRJNOWARN^ 


:DM0u::i. y2 


::iTTY 


,CMD/A^ 


5/NO 


*SY0Ji:i»2.:iRTS »CMD 


/PR J NO WARN:. 


■•DM0JLly2 


::iRTs 


.CMD/AJ 


>/N0 


)}csY0ji::i. !-2:iccL »cmd 


/PR 1 NOWARN- 


:DMO ; i:: :i. > 2 


;;iccL 


♦CMD/A5 


5/NO 


>KSYJi:::i, !-2::iCRASH .tmp 




=KB J 








(?SY0u::i. !-2:;iRTS*CMD 












(i?SYo 1 1:: :i. V 2::i ANALYS ♦ cmd 












&>SY0?I:J. y2::iCLEAN*CMD 












{??SY0J!::lv2:iTTY«CMD 












p(»SPOOL»CMDi::i. !'2::i 












(f?SY0Ji:;.u2::iccL*CMD 
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DETACH 

LOGIN KBOJ i::.i. j'2::i 

fof;;ce KBOt Rim 9Yti:::i. j-2:iut:i:i...ty 

FORCE KBOt REMOME LOGICAL LB 

FORCE KBO? ADD LOGICAL SY Ji: I j- :I.:L ::iLB 

FORCE KBOt EXIT 

FORCE KBOt RUN BY n: I s/ 2:1 QUE 

l-ORCE KBO t BY t L 1 9 8 ::i AN AL YS * DMP/DE 

l-ORCE KBO? EXIT 

FORCE KBOt BYE/F 

ATTACH 

FORCE KBO 

FORCE KBOt :l.00 

FORCE KBOt YES 

LOGINS 

SEND RBTS/li 

END 

"Z 

>{<SYoti:::i. !'2:;iCRASH ♦CTi, 
*sYti:::i. i'2::iCRASH »tmp 

>f<SYti:;:l. y2::iANALYS*TMP 

detach 

LOGIN KBOt i;::i. !-2;:i 

FORCE KBOt RUN SY t II :l. y 8::i ANALYS 

I" D R c E K B 1 i: y :i. ;:i c r a s h » b y s 

FORCE KBO t SY t L 1 v 8::i ANALYS » DHP/U IDE 

t" ORCE KBO t S Y t \: 1 v 8 IIERRCRB « F 1 1... 

FORCE KBOt BYE/F 
ATTACH 



RUN SYti::;U8::iERRINT 



IS NOW ON THE AIR 



/PR t NOW ARN::^:S Y t L' :l. ? 2 :\ CRASH ♦ TMP/ AS 
/DE t NOWARN 

=:^:KBt 



>xsYoti:::i. y 2 ::i ANALYS ♦CHD 

>KSYti;:iv2::iANALYS«TMP 

>i<SYOti;::i. i'2;;iCLEAN *cmd 

>KSYti;::l. y2::iUTILTY J-ILP 

»c s Y t !:: ;i. :» 2 ::i d i r e: c t * i-i i... i-- < 4 o :> 

>KSYti:;iy8;:iERRDIS*HLP 

>K {:> Y 1 1:: :i. f 2 ::i a c c: t * s y s < :i. 8 8 > 
>j<SYti:::i. y2::!C0PY J"Ilp<40> 



/PR t NOWARN='==SY 1 1: 1 s- 2 iil ANALYS ♦ TMP/ AS/NO 

/DEt NOWARN 

/PR t NOWARN^="DMO 1 1: 1 9 2::iCLEAN . CMD/ AS/NO 

••■■:=DMO 1 1:; ;i. v 2:;iutilty * hlp/ as/no 
••:4:iM0 1 1:: i v 2 ::i direct ♦ hlp/ as/no 

=--=DMO 1 1: 1 1> 2 :i ERRD I S » HLP/ AS/NO 
/PR t NO WARN====DMO 1 1: 1 9 2 3 ACCT ♦ S YS/AS/NO 

■■■■■'imo 1 1:: :i. 9 2 ::i copy » hlp/as/no 



Readw 

RUN SYt!:::l. y2:;iUTILTY 

UTILTY y7*0-07 RBTS «v'7 *0--07 Lar<=?e Swstwin 

=iN,..OGINS 

fEXIT 

Resd^;^ 



! * H< * * * * * * * W. S I ■' L E R « C T 1... •■" S F 1... 1 N G P R G R A M B U 1 1... D 

! Copwrij-Jht <C) .1.979 by D:i.<.-.{:i.tal E«u:i.p merit Corporat.i.oni' Mawriardj* Mass 



SCAI...E 
Ro;?adv.; 

OLD DMOti:::i. ?2:;iQUE»BAS 

Ready 

coMP I Li;;; s y 1 1:; :i. 9 2 ::i que <232> 

Ready 
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SCAI.J- 

OLD DM0 { i: :l y 2::iauEMAN ♦ dab 

Re<f}d« 

c (.) M !"■ :i; 1... In: s y : i: :i. 1-250 ;;i a d k: m a n 

SCALE 

OLD DM0 : i: :i. ? 2 :;i qumrun ♦ b as 
coMP ;i; LE s Y 1 1: :l v 250 :i qumrun 

Readv-j 

SCALE O 
ReadviJ 

OLD DM0 : c: J, y 2 ::i opber ♦ b as 

Rfr!3dW 

COMPILE BY tllv 2S0:i0PSER 
Re^adw 

SCALE 
Ready 

L D D M J i:: 1 7 2 :] o p s r u n ♦ b a s 

Readw 

COMP I LE S Y X 1 1 V 250 ::i OPBRUN 

Read'rf 

s{:;ale o 

Ready 

OLD dmo:i::l?2:]CHARB .bas 

Ready 

COMP :i; LE SY : i: ;i 1- 250 :] chars 

Ready 

RUN SY U: ly 250 :.1 CHARS 

CHARS <^7*0-07 RSTS \J7*0~07 Lar<Je System 

Ready 
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s:jcai.,.e 

Ready 

OLD DMon;:;i. y2::isp{:)ai... .bas 

Ready 

c; H I"' :i: i... i;;: s y ? i:: :i. y 25 ::i s i-- 1,.. 

SCA1.,.E 
Readw 

c) I... II D M 1 1: ;i. y 2 ::i s F' i... ;i; jci i... . b a s 

\"<BBd'::l 

C M I"' 1 1... 1:;: S Y t L 1 y 2 5 1 S F I... :i: B I... 
Ready 

scale: 

Ready 

1... B B M 1 1: ;i. V 2 ;:i S !"■ l... r u n * b a b 

Ready 

c C) M I"' 1 1... i;;: s y j i: :!. y 2 5 ::i s i-' 1... r u n 

Ready 

SCALE 
Ready 

1. D B M 1 r: ;i. ^ 2 ;:i b a t b c b . b a s 

Ready 

c; D M !"■ ;i: i... i;:: s y ? 1:: :i. y 2 5 :i b a t b c b 

Ready 

RUN SYn:::i. y25o::iBATBCB 

BATBCB M7«0--07 RSTS V7*0-07 Lar<=?e System 

Ready 

SCAI...E 
Ready 

1... B B M 1 1;: :i. y 2 ::i b a t c h * b a s 

Ready 

c M I"- :i; 1... i;;: s y 1 1: :i. ? 2 5 ::i b a t c h 
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Ready 

SCALE 
ReacJw 

OLD riMo : i: .1. v 2 ::i » at ;i: di... * b as 

R©c>dw 

c M p 1 1... lii: s Y u: :i. 1- 2 5 :i B A r :i: n i... 

Ready 

SCALE 

Ready 

OLD riMO tZlflJl BATBEC ♦ B AS 

Ready 

COMPILE SY til? 250:iBATBEC 

Ready 

SCALE 

Ready 

DLB BMO t Z 1 y 2::iBATRlJN ♦ BAS 

Ready 

COMPILE SY; i;::l. y250;JBATRUN 

Ready 



RUN SYti:.i. !'2::ip:tP»SA'v^ 
*SY 1 1: :i. 9 2 ;:i spool ♦ tmr^^^kb t 

DETACH 

LOGIN KB J i:;:i.y2::i 

FORCE KBt RUN BY J U. » 25010PSER 

FORCE kb: BETACH 

LOGIN KB 5 i:::u2:i 

FORCE kb: run byu:i, ?25<):iqueman 

FORCE KB : BET ACH/PR 1 OR 1 TY J 

LOGIN KBt i;:i. r2:i 

FORCE KBt RUN SY 1 1: J. . 2'50:iSP00L 

FORCE KBt LP0t/HEADt2 

LOGIN KBt i:.1. 1-23 

FORCE KBt RUN SY 1 1: :l. »2'50;:iBATCH 

FORCE KB t BAO t /ERROR t FATAL/NOQUEUE/NODELETE 

ATTACH 

"2. 

*SYO 1 1: 1 y 2:iSP00L ♦ CMD/PR t NOWARN=^^-SY 1 1: :l. y 2:tSP00L ♦ TMP/AS 

:*SY t C :l. y 2!] SPOOL * TMP/DE t NOWARN 

Ready 

RUN SYti:iy2:iCPATCH 

CPATCH .M7»0-07 RSTS M7*0-07 Lar«{e System 
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Fi Its to patch •■•• SYOn:::l. y2:]«TART.CTI... 

#KB t 

>^ t G/ ? eSPGOL ♦ CMD/-:l. ;l.C/{f?BPGOL * CMD/EX 

I'-' ;i} t c h f r o m .... K B 1 1," .1. » 2 ;.l « C M D c o m f .1. e t e ♦ 

^11="^ Z 

F:i. :i.e to patch •- ""Z 

ReBi:.hi 

RUN SYn;::i. 1-2:1 cp AT CH 

CRATCH g7*0--07 RSTS V7*0""07 LarsSe Bwstem 

F:i.:i.c to patch ••■• SYOU::l. ? 2:1 CRASH ♦CTI... 

■MKBt 

^tG/9 ©SPOOL . CMD/--:l. :l. C/((?SPOOI... » CMD/EX 

I"' 3 1 c h f V o in .... K B 5 1: :l. y 2 :i . C M D c^ o m p :i. e t e ♦ 

■■\n 

F;i. Ic to patch •••• "Z 
Read*;* 



! * >}! * * ;i< * * Xc * >K B I (•) 1"' R B C T I... •■•• i... A R G E P R G R A M B U 1 1. D 

i CDP*:n\i..<.-0)t (C) :l,979 bw n.i.<-J:i.ta.l. E«i..i;i.pment Corporation > Mawnardy Mass* 



BCAI.,.E 

Ready 

OLD DM0 ? 1: :L !- 2:ID;i:SPLY * BAS 

A I"' P P. N B D M 1 1: :l. (. 2 :i M 7' 05 ♦ D I-" Y 

Ready 

C M !"■ 1 1... 1;: S Y 1 1: :l, y 2 :i V T 5 D I-' Y ■< 2 3 2 i: 

Ready 

SCALE 
Ready 

OLD DMon::i. y2:iD:i;sPLY*BAS 

Ready 

A P I"' E N D D M J 1: :l. y 2 J V -If 5 * D P Y 

Ready 

C M P 1 1... 1;;; S Y 1 1: :i, !» 2 :i V 7' 5 1-' Y < 232;:^ 

Ready 

SCALE 
Ready 

OLD DMon::i. ^'2:!F:l:T»BAs 

Ready 
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COMPILE by:i:::i. !.2::lF:l:T<232> 
SCALE 
Ready 

L i:i » M 1 1: :i. 'J 2 ::i i-" i... ;i: n j » b a b 

Ready 

c M p :i: L li;; b y 1 1:: :!. ? 2 :i i- 1... :i: n t < a o > 

Ready 

SCALE 
Ready 

1... i:i imoit i ^ 2 :;i p m d u m p » b a s 

Ready 

COMPILE BY 1 1: :i. y 2::iPMDUMP<4(» 

Ready 

SCALE 
Ready 

1... D n M ! i: :i. 9 2 ::i b r-- c r e i-' * b a b 

Ready 

COMPILE BY 1 1:: :i. ? 2;:ibpcref<4o> 

Readvj 

SCALE 

Ready 

1... D III M J i: :l. 9 2 1 B P C R I-" 1. ♦ B A S 

Pileady 

c M p 1 1... E s Y 1 1;: :i. > 2 ::i B p c r i-' :i. < 4 o > 

Ready 

SCALE 

Ready 

L D B M J r 1 > 2 :i R- IJ N F I-' ♦BAB 

Ready 

c M p 1 1... E s Y J i:: :i. y 2 ::i r u n o i-' f < 4 o :: 

Ready 
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BCAI...!:- 

1,., D D M 1 \: 1 y 2 3 M A K S 1 1... . B A S 
Raadw 

COMPILE sYn;:;i. y2::iMAKs:i;i,.. 

Readw 



RUN SYn:;:i. !-2:;ip:i:p.sav 

>!<SY n: :i, y 2:;iSAVRE s « SAM<:i.24>/RTS n^rr :i. j.=:^^i:iMO n;: :i. >- 2::iSA>^RE s * SAM 

:*'-Z 



Read*:J 



RUN svn: 
>KBYn:::i. y^: 
>{«8Yn::;i, v:;; 
:*SYti:::i. !-; 



:i. y2::ip:i:p«8AU 

^:;iBPCREF . H!..,p<40>^::a:iM0 j i: :i. y 2:ibp(;;ref * hlp/ab/no 
> :;i I"" I T * i-i I... !"' •=:: 4 o :> ■■■■•■■■ i\ m o 1 1: i y 2 ::i f 1 t » i-i i... p / a s / n 

>::i RUNOFF . RN0<40>'^^=IiM0 1 1 1 y 2 ;:i RUNOFF ♦ RNO/AB/NO 



Read^j 



!***>!<***)!<** B A C; K U P , C T I... ••■■ B A C; i< U I-' I-' R G R A M B U 1 1... JCi 

! D F '.:f r i ;}i h t ( C ) .1. 9 7 9 b \:f D :i. si i t «} I E. (s u .1 p m e ri Iv o r p o v a t :i. o ri y M a ^:J n a r' d y M a s s . 



b(:;ale o 

Ready 

OLD DMOn:;:!. y 2 :;i BACKUP* BAB 

Ready 

C M P 1 L E S Y t \:. 1 y 9 9 ::i B A C; K U P < 2 3 2 :: 

Ready 

SCALE 

Ready 

L B B M 1 1: ;l. y 2 ::i B A C i... S J . B A B 

Ready 

COMPILE SY 1 1:; 1 y 99::iBACLBT<232;: 

Ready 

SCALE 

Ready 

OLD DM0 1 1: :l. y 2 .1 BACCON * BAB 

l-i;eady 
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COMPXLIH: SY: C:1 y99:1BACC(:)N<232> 
SCALti: 
R(ji3dy 

OLD DM0 J H 3. » 2 3 B ACD 1 R * B AS 
Rteajdy 

COMP I LE SY i \: 1 9 99 :i B ACD 1 R<232> 
Readw 

SCALE 

Read^; 

OLD DM0 tZly 2 ::i B ACMNT ♦ BAS 

Ready 

c; M p :i: l e s y i i: :u 9 9 :] b a c m n r < 2 3 2 > 

Ready 

SCALE 
Ready 

OLD DM0 J r ;i. s- 2 :;i b acl ab . b as 

Ready 

C M !"• J I... E S Y 1 1:; :i. V 9 9 1 B A C L A B •=:: 2 3 2 :> 

Ready 

SCALE 

Ready 

OLD DM0 1 C :l. » 2 ::i B ACDSK ♦ BAS 

Ready 

COMPILE SY 1 1:: :l. y 99:;IBACDSK<232> 

Ready 

SCALE 
Ready 

1... D D M J i:; :i. r 2 ::i b a c \< i o ♦ b a s 

Ready 

c M I"' ;i: L i;;: s y n:; :i ? 9 9 :;i b a c k t o < 2 3 2 > 

Ready 
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SCALE 

Read v.* 

OLD DM0 i Z 1 9 2 1 BACCOM , BAB 

Readw 

COMPILE SY % 1 1 f 99::iBACC0M<232> 

Readw 

BCALE 

Readw 

OLD DM0 t L 1 f 2 ::i B ACDMP * BAB 

Readw 

COMPILE SY? i::;f, !'99:]BACDMP<232::= 

Ready 

SCALE 
Readw 

OLD DM0 J i: 1 y 2 ;;i bacdel ♦ bas 

Ready 

COMPILE SY t \: 1 9 99::iBACDEL<232> 

Ready 

SCAI...E 
Ready 

OLD DM0 1 1;: ,1. 9 2 :\ b aclod ♦ bas 

Ready 

c M I"' :i: I... In: s y 1 1:; ::i. i- 9 9 ::i b a c; i... o d < 2 3 2 :: 

Readi;? 

SCALE 
Ready 

OLD DM0 n;; ;L y 2 :;i bacent ♦ bas 

Ready 

c M p 1 1. E s y i \: ;i. s' 9 9 :;i b a c e h t 

Ready 
SCAI...E 
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Readw 

OLD tiMO : C J. r 2::iBACFRM ♦ BAS 

COMPILE SY J t: 1 y 99::iBACFRM<232> 
Ready 

SCALE 

Read»;i 

OLD DM0 J i: 1 9 2 :.1 BACPRM ♦ BAB 

c M p I L E s Y J i;: :i. s- ? 9 ::i b a c p r m 

Re^adw 

RUN s Y : i:; i y 99 ::i b acprm 

BACPRM V7.0-07 RBTS V7»0--07 Larf.-te B^jsteir. 
Ready 



I********** DEyiST.CTL •••■ DE>^:i:CE EXERCIBER PROGRAMS 

! Copyr.i.«?ht <C) :l.979 by D ;i, >•< i t a J. Eaulpmerit Corp(:)rat.i.on ? Maynardc Mass. 



SCALE 
Ready 

OLD DM0 J i: 1. r 2 ::i dskbek . b as 

Read v.; 

COMPILE SY X 1 1 y 44:;iDSKBEK 

Ready 

SCALE 

Ready 

OLD DM0 X r: :l y 2::iDSKEXR ♦ BAB 

Ready 

COMP I LE S Y IC .1. y 44 1 DSKEXR 

Ready 

SCALE 
Ready 

OLD DM0 : i: :i. y 2 :i lpexer . b as 

Ready 
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c M p :i: I... E s Y 1 1: i s- 4 4 1 1... p e x i;;: r 

Rei!>dw 

*;>(:; ALE o 

ReBchf 

01... D DM0 1 \: 1 V 2 :;i ppexer . b as 

Ready 

c; M !"' 1 1... i;:; s y 1 1:: :i. y 4 4 :;i i-- 1-' e x i:;: r 

Read'::} 

SCALE 
Ready 

(J f .. II D H J i: 1 9 2 ::i F' i^;; i:;: x i;- r . b a s 

Ready 

c ';:) M I"" :i: i... i;- s y n:: i y 4 4 ::i i"' r e x i:;: i^;: 

Ready 

scali;;: o 

Readvi! 

L D D M 1 1: 1 y 2 :;i B X li- X E R * B A S 

Ready 

coMP I LE s y 1 1: :i. v 44 ::i dxexer 

Ready 

<!>CAI...E 
Ready 

n L D B i^ 1 1:: i v 2 ;:i b t e x e r » b a s 

Ready 

c C) M F- 1 L i;;: s y 1 1:; :i. y 4 4 ;;i b t e x i:;: i^;; 

Ro;jady 

! ERRORS WILL. RESULT WHEN THE CPEXER PROGRAM IS BUILT 

! USING C8PC0M OR BASIC PLUS IF THE NECESSARY MATH OPTIONS 

! WERE NOT SELECTED* 

SCALE 

Ready 

1... B B M 1 1: :l. y 2 3 C P E X E R « B A S 

Ready 
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COMP 3: LE £> Y n: ;l, y 44 3 CPEXER 

SCALE 
Readw 

OLD DMO t r.: :i. > 2 ::i cpur st . bas 

Readw 

C M P I L !;•;: S Y U: :l. y 4 4 1 C P U T S 7 

Read;:* 

SCALE 

Rcjiifdw 

OLD DMO tllr2 ilKBEXER ♦ DAS 

COMP :i: LE s Y 1 1: :i. p 44 :i kbexer 

Readv; 
SCALE 

OLD DMO J 1: J. » 2:]MTEXER » BAB 

Re<i>dw 

COMPILE BY n: :l y 44:]MTEXER 

Re<:}dw 



*** BU:i:LD complete? *** 
Reach! 

RUN $p;i:p 
*$not:i:ce.txt 

welcome to rsts/e v7»0 time sharing 



*SYSt|iNOT;i;CE*TXT:"=KBI 

RSTS/E K>7*0 IS ON THE AIRr WITH 

LARGE FILES 
AND 
DATA CACHING! ! ! 
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*<|iHELP»TXT 

TO GET ON-LINE AND USE R'STB/E^ FOLLOW THE 
INSTRUCTIONS FOUND IN THE 
RSTS/E SYSTEM USER'S GUIDE* 

**HELF%TXT==''KBJ 

SEE DAME AT EXT* 350 FOR INFORMATION ON USING 
THIS RSTS/E TIME-SHARING SYSTEM* 

*$START*CTL 

(9SY0:i:;J.y2:]RTS*CMD 

(»SY0:[::L»2:iTTY»CMD 

{?SF'00L.CMDL1»2.1 

(»SY0tC:Ly2:iCCL.>CMD 

DETACH 

LOGIN KDOJ r:i»2:3 

FORCE KBOt RUN SY J C 1 ?2:iUTILTY 

FORCE KDOJ REMOVE LOGICAL LB 

FORCE KDOJ ADD LOGICAL BY J LI ^ II JLB 

FORCE KBOJ EXIT 

FOFv'CE KBOt BYE/F 

ATTACH 

FORCE KBOJ RUN SY J CI »8:3ERRINT 

FORCE KBOt 100 

FORCE KBOI NO 

LOGINS 

SEND RSTS/E IS NOW ON THE AIR*** 

END 

**CRASH*CTL 

eSY0tCl»2.TRTS*CMD 

(SSYO J C 1. » 2.1 ANALYS * CMD 

l3SY0Ji:i»2::iCLEAN*CMD 

C>SY0Ji::lr2:iTTY*CMD 

(»sf'Ool*cmdi:ik2:3 

eSY0Ji:;;Lr2:iCCL*CMD 

DETACH 

LOGIN KBOJ i::l.»23 

FORCE KBOJ RUN SY J C .1 ?21UTILTY 

FORCE KBOJ REMOVE LOGICAL LB 

FORCE KBOJ ADD LOGICAL SY J III » 11.3 LB 

FORCE KBOJ EXIT 

FORCE KBOJ RUN SY J I."!.!. »2D0UE 

FORCE KBOJ Q SY J i: I »8:iANALYS*DMP/DE 

FORCE KBOJ EXIT 

FORCE KBOJ BYE/F 

ATTACH 

FORCE KBOJ RUN SY J CI r S3ERRINT 

FORCE KBOJ 100 

FORCE KBOJ YES 

LOGINS 

SEND RSTS/E IS NOW ON THE AIR*** 

END 

*$ACCT*SYS 

*SYtHiACCT*SYS-"KBJ 

3 y 3 c A C C; T' ? y > A C; C U N T 1 N G 1-" F 1 C E 

9 y 1 y 4 3 9 1 2 J- !- >. S E C; U R I T Y F F 1 C E 

99 y 99 V GAMES yO c v GAMES ACCOUNT 

100 y 100 y DEMO y y y SYSTEM DEMO ACCOUNT 
'-2 

Readvi 

RUN $REACT 
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REACT V7*0™07 R8TS V7»0-07 Larsje Swsteiir 

S 'J s t e m A c c o u n t M a n a si e t' 

Funct.i.on? STANDARli 

? N a irr (v? o t' s c c o u n t r;i o w e >< i t> t s - I'" a :L 1 u r e^ t a E' N T E R A c a o u n t J C 1 » 1 J DEMO 

RYBTEM HEMO ACCOUNT 

A;|, .1. Accounts j,n Account File are? now Entered 

Function? ""2 

RUN $SHUTUP 
SHUTUP M7.0~07 RST8 Kf7 A)~07 Lavsie System 

OBJ 4:1. PM 22 -Apr 79 ######## Set-UF Dialos^ue Phase *#*##l'## 

Tvjpe 'ESC <.' ALT' ) to any (suerw to backup one CD step 

' 1-' 3 £ R' ' i"i o ■(•, r* u ri n :i. n ^i 

Minutes until system shutdown (0--99) <5>? o 

08 J 41 PM 22-Apr"-79 #:||:##=ll:### Warnini^ Messa^^e Phase *#*****# 
Further LOGINS sr^^ now disabled 

08 Ml PM 22-Apr--79 *###•*##* Initial Job Killing-? Phase **=!!=*#*#* 

08 J 41 PM 22--Apr-79 ### #-l**# Remove RTS/REB LIB Phase #####*#* 

08 J 41 PM 22"Apr-79 ###t#l=*# SWAP File Removal Phase #**##*#* 

08 J 41 PM 22~Apr-79 #:B-###*=I1=# Disk DISMOUNT Phase ****#*#* 

08S41 PM 22--Apr--79 ######## Final Shutdown Phase #*#*#*#* 

I"' lease wait for system to re-boot itself 



Warnin<-$ >k>K DB2J is dual por tods' proceed with caution! 
W a r i-i i n ;;,{ >K M Ii B 1 1 i s d u a 1 p o r* t e d y p r o c e e d w i t h a a i„i t i o i "i ! 

R8TS i^7*0--07 LarsJe System (BRO) 



Option? 8AVREB 

22-Apr-79? 

Enter date as 'DAY--MONTH-YEAR' (e*s5»y 31-DEC--76) 

or as 'YEAR* MONTH ♦BAY' (e.s^J** 76 ♦12* 31) ? 22-APR-79 

08 J 42 PM? 

Enter time as ' HOUR t MINUTES AM' or 'HOUR {MINUTES PM ' (e.sS» IM^ PM) 

or in 24 -hour format as 'HOUR {MINUTES ' <e*«U i;j{15) ?B{42 PM 
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J;5AV/F;;ES F-unctlonJ 

Please enter one of the valid SAM/RES f u net ions y 
or tvisr-e 'HELP' for a heJ-p mesifi.aj^e t HELP 

1 h e V <•;! .1. :i. d S A "v* / R 1:-: S f i..i i"i c^ t :i. o fi s b r e t 

SAVE Make a safe cofw of a RSTS/E f ;i, le -struct u red d:i.sk* 
RESTORE Restore a RSTS/E f :i, :i.e-st rue tu red disk from a SAVE Set* 
IMAGE Coi-"::t B volume ima<;.«e from a RSTS/E f i:i.e-st rue tu red disk 

to a L:i:KE disk* 
:i:DENT:i;FY List the characteristic's of a SAME Set or RSTS/E disk* 
HELP Print this list of acceptable responses* 

Q n 1 \:t t h e f i r* b t t w o c h a r a c t e r s n e e d be t ^.j p e d * 

<:> A V / R i;- s I-- i,.i i"i c t i o n i ;i: n e n t i f y 

From Device? 

Type 2 characters to specify the input device typey 
followed by a sini-Sle dis.{it (.0-7) to specify the unit 
I'lumber ♦ 

Include a Save SO'jt name or Pack ID if wou want SAMRES 
t Q e I "I II;. u V e i t in b t c h e s t b e o i"i e o n t f't e v o 1 i.,i in e * T' h ;i. s d rive 
^i» h o u 1 d be W R 1 T E •••• I... C; K E D * 

From Device? DM1 

Device? DM1 J 

Pack ID J SAMPLE 

P a c k C I u i;> t e r* s i x^ e * 4 

C r e <•! t i Q n. d a t e ♦ S u i"i d b \:{ ? 2 2 - A p r ••■• 7 9 



SAM/ 1^!; i:;: S !■• 1..1 n c t i o n J SAVE 

F r' o m 1^' S T' S d i s k ? 

Type 2 characters to specify the input device typey 

followed by a s insole di^Jit (0-7) to specify the unit 

riumh;>ei'* 

Include a Pack Id if you want SAVRES to ensure it 

matches the one on the volume* This drive should be 

WRITE LOCKED* 

From RSTS disk? DROJ 

){o|of< Pack ID/default Save Set Name is B1GV70 

To Device? DM1 J RECOVR 

^^^ J h e V o 1 u in e o n D M 1 J i s b R S T' S d i s k 
>K** Pack ID is SAMPLE 

)K)}oj< Pack will be reinitialized 

Mount it anyway <N0>? 

:*** This is your last chance to prevent the 

^"^t loss of <:M-iy data on the output volume 

Mount it anyway <N0>? YES 

*** Save Set Name is RECOVR 

E X p i r' a t i o n D a t e ■•:: 2 1 •" A p r - 8 > ? 

Type the desired expiration date or press the LINE FEED 
key to accept the date printed* 

Expiration Date <21™Apr""80>? 21-APR-82 
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Verify <Yes or No) <N0>? YEB 

I"' T' o c e e d ( Y e <s o r No) ? 

T w p e ' Y e s ' i, o p r« o c e (•■» d w i t J» l, he o p e? v a t i o ri . 

Twpe 'No' to abort smd retur'n to the SAV/REO Function J proiript* 

Proceed (Yeis or No)? YEB 

*** :i:n:i.t.i.a:i.:i.z:i.ns^ fir«t SAVE voiluine 

)}<)JoK Besrln SAME from DROJ to DM.! J at 09 J 00 PM 

:*** Be<^.i.n VERIFY tr'&ss from DROJ to DMJ. J at 09:01 PM 

>!<** differences found 

D i <!> in c:) i..i ri t D e v i c e * D M :l. ♦ 

Set Name J RECOVR 

Sea #: 1 

C r e a t i o n d b t e t S i..i n d «>«;<» 2 2 ™ A p r- - 7 9 

E 5-; p i r- ,if t i o ri d b t e ♦ We d i "i e s d a ^-f y 2 1 - A p r ••" B 2 

1"' :i. e a s e .1 a b e 1 t h i s v o 1 i..i m e ! 

— SAVE operation completed at 09 J 02 PM 

Summarw Report 

SAVE of IiR0?B:i;GV70 to Save Bet RECOVR 

Input Device? DROI 

Pack :i;rij b:igv7o 

P a c k C I I..I s t e r s i z e t B 

C r e B t i o n d a t e ♦ S u n d s <!■.{ f 2 2 - A p r - 7 9 

u t p u t D e V :i. c e t U i s k 

Set Name: RECOMR 

# of volumes: 1 

C r e a t i o ri d a t e : S u n d a h ? 2 2 - A p r* ~ 7 9 

E X p i r> a t i o i "i d a t e : U) e d n e s d a y ? 2 1 - A p i' •- 8 2 

SAVE started on Sundawr 22 -Apr -79 y at 09: 00 PM 

R u n S t a t i s t i c s 

T r a i"i s f e r T o t a 1 s * 

Total of 10920 blocks transferred 
Error Totals: 

Total of bad compares* 

Total of new bad blocks encountered on source* 
Total of new bad blocks encountered on destination* 

rimin;-< Totals: 

Total elapso'jd time: hrs*y 2 mins*y 7 sees* 
T o t a 1 w B i t t i in e : hi r* s ♦ y in i n s * y s e c s * 

Total process time: hrs*y 2 mins*y 7 sees* 

SAV/RES Function: 

Option: START 
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You currentlw have J JOB MAX ■■•■ SOr SWAP MAX :« 31K* 

JOB MAX or SWAP MAX chansJes? NO 

Anw moiTiory allocation chansJes? MO 

You currently have crash dump enabled* 

Crash duiviF? YEB 

2 2 -■•Apr™ 79? 

09? 06 PM? 

DBO* disabled - unit not present 

;l. device disabled 

INl'T V7»0-07 RSTS ^7*0-07 Lar<-{e System 

Coininand File Name? 
DliETACHliMG.** 



HELLO 1/2 

Password* 

Job 1 is detached under this account 

Job number to attach to? 

1 other user is lojiJjiJed in under this account 



Ready 

RUN *UT1LTY 

UTILTY y7»0-07 RSTS V7»0-07 Lar<.je System 

'lADD RTll 

♦ADD RSX 

?Can't find file or account - in ADD 

=11= ADD RMS 11 

?Can't find file or account -• in ADD 

=II=ADD BP2C0M 

?Can't find file or account •- in ADD 

=II=ADD BP21C2 

?Can''t find file or account - in ADD 

#ADD BASIC 

?Name or account now exists •-• in ADD 

=II=ADD BAS4F 

?Can''t find file or account - in ADD 

=II=ADD TFCO 

=ii=Ex:rr 

Ready 
BYE/F 
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ATTACHING TO JOB 1 
DETACHING. .♦ 



"^C 

HELLO :l./2 

Job .1. is det<"}ched under thi«; 3C count 

Job number to attach to? 

:l. other user is lo i-ii-ied in under this account 



Read*;i 

RUN *TTYSET 

TTYSET M7.0-07 RBTS V7.0-07 Lars^e Swstem 

ler in i n b 1 c hi b r b c t e r i s t i c s f r o f-i r b ivi 

? EXIT 

Read*;* 

BYE/F 



ATTACHING TO JOB 
DETACHING* . « 



'"C 

HELLO :l,/2 

Password J 

Joh'i :l. is dert ached ui'ider this ac'count 

Job number to attach to? 

J. other user is Io<;.{.<;?ed in under this accouni 



Readw 

RUN SY: <.1. p2S0)0PSER 

OPSER V7.0-07 RBTS M7.0-07 LarjMe S^;{stem 

'OPSER' FILES NOT FOUND ••■• WILL INITIALIZE. 

:||=DETACH 

DETACHING . . ♦ 
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'T 

HELLO ;l./2 

P 3 Si sword* 

Jobs 1 2 are dtrtachad under th:i.s account 

Job number to attach to? 

2 other users i»ve Xos-Sded in under this account 



Readw 

RUN SY t ( 1 » 250 ) QUI!." MAN 

QUEMAN V7t0™07 RBTS V7»0-07 Lar<:^e S»:<stem 

' QUEUE >WRK' NOT FOUND - WILL INTTI ALIZE 

NO QUEUE f:i:le found w:i;ll initialize 

STARTED AT J 09 {07 PM ON 22Apv 79 

INITIALIZED 

# 

JOB ¥3 'QUEMAN' PUT ONLINE 

XiiETACH/PRIORITYJO 

DETACHING ♦ ♦ ♦ 



HELLO ::l./2 

Password* 

Jobs 1. 2 3 are detached under this account 

Job number to attach to? 

3 other users are lo!:i<!ie(:i iyi under this accouni 



Readw 

RUN BY J CU 250) SPOOL 

SPOOL <J7«0-07 RSTS ^7*0- -07 Lars^e Swsteir. 

#LP0J/HEADJ2 

Detachin<-{« ♦ ♦ 



HELLO :l/2 

Password* 

Jobs 12 3 4 are detached under this account 

Job number to attach to? 

A other users are lo^A^j'^ed in under this account 



Readw 

JOB #4 'LPOSPL' PUT ONLINE 

MESSAGE :l. t 22-Apv 79 09 J 07 PM JOB J 3 DET QUMRUNi:::!, i- 2; 

LPOSPL (4) PUT ONLINE 
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RUN SYt CI. ^250) BATCH 

BATCH V7.0-07 RSTS V7 A)-07 Larj-te System 
#BAO X /ERROR % FATAL/NOQUEUE/NODELETE 
DETACHING* ♦ . 



ATTACHING TO JOB 
DETACHING* « ♦ 



HELLO :l./2 

Password* 

Jobs 1 2 3 4 5 &v<-.i detached under this account 

v)ob number to attach to? 

5 other users btv-i ;i,o<^<-ied :i.n i..inder this account 



Ready 



JOB #5 'BAOBPL' PUT ONLINE 

MESSAGE 2 X 22 -Apt 79 09 J OS PM JOB J 3 BET QUHRUNd. » 2 

BAOSPL (5) PUT ONLINE 
RUN <l!-2)UTILTY 
UTILTY M7*0-07 RSTS k^7*0-07 LarsSe System 

ii= t: c: 1... A r t ■••• a c i -i ■■■■■■■■ < :i. y 2 ) 1... g :i; n * :* 5 1-' r :i; u 3 

=II=CCL ATP-K-:^= < :l. V 2 ) ATPK ♦ * ? PR I U 30000 

^11= C: C; L B C K •••• :::' ( ;l. 1/ 2 ) R M S B C K * I' S K ? 

=iN:CI... BPC--REF=:=: ( I !- 2 ) BPCREI-' * % 5 30000 

11= c; c L B Y i;;: ■•- ^^■■■- < ;i. ^ 2 ) i... b u r ♦ * ? i-- 1-^ i u 

ni-CCL CNU-;:-' ( :l. y 2 ) RMSCNU * TBK ? 

=11= c c I... c R i;;: •- ate ==== ( :i. y 2 ) £ d i r * >!< p 3 

=11= C; C L D E I"' •- ==== ( :l, y 2 ) R M S h E \"\1 S K y 

=in:;ci... bfn-==== < i y 2 ) rm<:5bfn . tsk p 

=II=CCL »ES-==== ( :!. y 2 ) RMSDES » JSK ? 

=1I=CCL B I S--MOUNr •■•■== ( 1 y 2 ) UMOUNT <■ * 5 l"'l-;; I U 30000 

=II=CCL B I --RECITOR Y==== ( 1 y 2 ) B I RECrr * * P PR I U 30000 

=11= C C; L D S I"' - ==== ( 1 y 2 ) l^i: M S B S !"• * f S l< y 

=IH:CL EBT-==== ( J. y 2 ) EBT * rSK 5 

=IN:CL EB-IT===(:I. y2)EBIT**J30000 

=II=CCL I"' I T-==== ( :l. y 2 ) F I T , * P l-'R I M 30000 

=11= C C I... H E I. L •■•• === ( :L y 2 ) 1... G IH.tv P R I K> 

=il=CCI... IFI...-==== < I y 2 ) RMSII-'L * TSK P 

=ih:cl lbr--==== ( ;i. y 2 ) lbr ♦ rsK p o 

=II=CCL L I B"R==== < ;l. y 2 ) L I BR * SAM P 8208 

=il=CCL L I N--K==== ( .1. y 2 ) L I NK * SAM P 8208 

=ICCL LOG •••■IN==== < .1. V 2 ) LOGIN * t ? PRU^ 

=«=CCL M ACR-0==== < .1. f 2 ) MACRO * S A'v^ ? 82 .1. 6 

=1I=CCL MAC-=== < :i. v 2 ) MAC ♦ TSK ? 

=(I=CCL MAK™E=== < I y 2 ) TECO * rEC ? 

=1I=CCL MOU--NT=== ( :l. y 2 ) UMOUNT * * P PR I M 30000 

=II=CCL MU-NG==== ( :l. y 2 ) TECO * TEC P 

=I)=CCL PAT-=== ( ;l. y 2 ) PAT * TSK' ? 

=11= C C; L P I P ■••• === ( ;l. y 2 ) I"' :i: I"' * S A U y 8 2 8 

=II=CCL PL-EASE==== < 1 y 2 ) PLEASE * * J PR I M 30000 

=IK:CI... OU--EUE==== ( :l. y 2 ) QUE . * ? PR IV 30000 

=II=CCL RST-==== ( :l. y 2 ) RMSRST . TSK ? PR I K) 
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# C C 1... S lii: ••■• 7' ■■■■■■' < ;l. y 2 ) T J Y S E T ♦ )K ? I-" RW 30000 

=II'CCL BR'r-:=" ( :l. > 2 ) BORT , TSK ? 

#CCI... BU--BM :i; T=== ( :l. y 2 ) QUE » >!< ? PR :i: M 30000 

#CCL BW™ I TCH-= ( .1. V 2 ) SW 1 TCH , ^. v PR :i: M 30000 

#CCI... S Y--STAT==^= ( ;i. y 2 ) SYBTAT * * y PR :i: Kf 30000 

#CCI.,. TE ""CD:- < :|, J, 2 ) "rECO « TEC ? 

=II=CCI... TKB""=='= ( :l. y 2 ) TKB * TSK 5 

=H' C C I... T Y "" I"' E ■■'■■■■ ( :l. y 2 > 1 E. C C <• T E C y 8 

#CCI.,. U T "" ;i: I... TY •••■••= ( t y 2 ) UTJLTY <. * y 30000 

#ex:i:t 

Readw 
BYE/F- 



AT T ACHING TO JOB 
DETACHING* * . 



HELLO 1/2 

Pas'ijwo rd* 

Jobs .1. 2 3 A S are detached under this a<:;c''Di..ii'it 

vJab rnjinber to attacKt to? 

5 other users Br& losi:^ed :i. n under tfil s account 



Ready 

RUN SYKl y2)LIT:i:i...TY 

UTILTY V7*0""07 RBTS V7»0""07 Lar::.Se B-Jstem 

#REMO<v^E LOGICAL LB 

#AnD LOGICAL BY J ( ;l. y :l. 1 ) LB 

#EXIT 

Ready 

BYE/F 



System Generation Examples E-127 



ATTACH liiNG TO JOB :l. 
RUN SY: (J. y 8) err 3: NT 

:l.oo 

NO 

Reath:* 

ERRJ:NT V7A>-i)7 RST8 M7*0-07 Lar)i-?e> B<:;stem 

ERR LOG Fi:i.e is 2% Fu:i.:i. 

(::hcM-i<;«e! B:i.ze to < ;l.00 >? 

Ut:i,:i.:i,:v:;e Crash F:i.:i.e Output (Yes/No) <No>? 

.Detach in^i? « ♦ ♦ 
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Index 



AC line frequency 

50 Hz, 3-41 

60 Hz, 3-41 

set with HERTZ, 3-29 

specify, 3-41 
Account [0,1] 

changing characteristics in, 3-59 

copy files from, 3-20 

create files in, 3-58, 3-59 

delete files in, 3-58, 3-59 

error message file in, 3-74 

in file status table, 3-54 

mark files as deletable, 3-59 

minimal file set, 3-20 

monitor in, 7-3 

patch, 3-22 

run-time system in, 3-74, 6-15 

system file, 3-6 

UFD for, 3-6 

use of INSTALL option, 3-46 

use of PIP.SAV program, 3-60 
Account [1,1], 3-5 

IVIFD, 6-14 

IVIFD cluster size for, 3-6 
Account [1,2], 4-3, 6-1 

BUILD in, 6-10 

system files in, 7-2 

system library, 3-6, 6-2, 6-11 
Accounts 

create user, 1-4, 6-23 

limit of user, 3-6 

maximum files in, 3-6 
ACCT.SYS standard account file 

creating, 6-23 
Acoustic coupler, 4-8 
ADD command, 7-3 
Address 

assignments, 1-5, C-1 

base, 3-23 

CS3, C~8 

devices with fixed, C-8 

even octal transfer, 3-101 

extended buffer, 3-85 

fixed, 3-32 

floating, 1-5, 3-32, C-1 

incorrect vector, 3-37 

for locking memory, 3-81 

non-standard controller, 3-36 



Address, (cont.) 

non-standard UNIBUS, 3-37 

non-standard vector, 3-32, 3-37 

odd transfer, 3-101 

offset, 3-23 

RH70 High Speed I/O Controller, C-8 

UNIBUS, 4-7 
Addresses 

summary of hardware bootstrap, 2-3t 
Addressing, 22-bit 

in HARDWR list, 3-33 
ANALYS program, 3-82 

extract error log data, 3-81 

report from, 3-81 
ANSI standard card code, 4-11 
ASSIGN command, 3-87 
Assignments 

address, 1-5 

vector, 1-5 
Attributes 

file, 3-6 
Automatic Restart 

DISABLE in SWITCH suboption, 3-42t 

ENABLE in SWITCH suboption, 3-42t 
Autopatch distribution medium, 1-6, 6-4, 6-14 

for BUILD, 6-2 

copy patches from, 6-5 

mount, 6-5 

RSX RTS, 6-9 
Auxiliary run-time system 

add, 6-18 

use BASIC-PLUS as, 7-3 



B 
.BAC extension 

for run-time system, 6-15 
Backup 

with SAVE/RESTORE, 3-104 
BACKUP Package 

in BUILD, 6-17 
BACKUP. CTL control file, 6-11, 6-13, D-lt 

programs and files, D-5t 
Bad block file, 3-61 

add to, 3-61 

allocate to, 3-46 

BADB.SYS file, 3-6 
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Bad block file, (cont.) 

examine, 3-46 

expanding, 3-61 

list bad blocks in, 3-61 

update, 3-46 
Bad blocks 

DSKINT counts, 3-8 

example of, 3-16 to 3-18 

pattern checks for, 3-5 
BADB.SYS file 

add cluster number to, 3-8 

allocate pack cluster, 3-61 

bad block file, 3-6 

entry in UFD, 3-6 
BADS suboption, 3-54t 

ADD in, 3-61 

clean disk, 3-61 

example of, 3-61, 3-62 

EXIT response in, 3-61 

invoke, 3-61 

LINE FEED response in, 3-61 

list bad blocks, 3-61 

use of, 3-61 
BAE address, C-8 
Base address, 3-23 
BASIC-PLUS-2 language, 4-20 
BASIC-PLUS-2 Run-Time System 

add optional, 6-18 

add RMS-llK support, 6-18 

add RSX support, 6-18 

as default, 6-7 

BUILD as default, 6-3 

change to, 6-24, 6-25 

distribution medium, 6-10 

mathematical functions, 1-3 

memory placement, 3-83 

reinstall, 6-10 

select for BUILD, 6-15 

shut down, 6-24 
BASIC-PLUS module sizes, B-3t, B-4t 
BASIC-PLUS Run-Time System 

as auxiliary, 7-3 

as default, 3-74, 6-7, 7-3 

command level prompt, 6-1 

contiguous space for, 7-1 

declaring settings in, 1-3 

generate, 4-6, 7-1, 7-3 

memory placement, 3-83, 3-84 

memory requirement, 4-6 

name, 4-6 

optional features, 4-20 

patching, 4-6 

shut down, 6-24 

swap maximum limit, 3-73 
Batch control file, 4-22 



BATCH error messages, A-14, A-15t 
Batch processor, 1-31 
BATCH program, 4-19 

requires pseudo keyboard, 4-8 
Batch stream, 1-3, 1-34, 4-23 

copies files, 4-1 

CREATE, 1-22, 7-2, A-14 

SYSBAT,, 1-31, A-14 
BIGPRG.CTL control file, 6-11, 6-13, D-lt 

programs and files, D-5t 
Binary Synchronous Communication, 4-12 
Binary word values, 3-5 
Bit 

do not delete, 3-60 
Block number 

for bad block, 3-8 

example of, 3-12, 3-13, 3-16 to 3-18 
Blocks 

doubly-allocated, 3-53 
BM792-YB Hardware Loader, 2-5 
BM873-YA bootstrap procedure, 2-4 
BM873-YB bootstrap procedure, 2-4 
BOOT command, 1-32 
BOOT option, 5-1 

dialogue error messages, 3-lOOt 

example of, 3-100 

invoke, 3-99 

reboot after patching, 1-16 

for Target monitor, 1-32 

use in PATCH option, 3-24 

use of, 3-2t, 3-99, 3-100 
Bootstrap 

disk, 3-99 

distribution medium, 1-12, 1-13, 2-1, 2-2 

initialization code, 1-2 

magnetic tape, 3-99 

manual load, 2-8 

prints register contents, 2-7 

record, 2-1 

simulates hardware ROM, 3-99 

successful completion message, 2-1 

Target disk, 5-1 
Bootstrap addresses 

summary of hardware, 2-3t 
Bootstrap procedure 

BM792-YB, 2-5 

BM873-YA, 2-4 

BM873-YB, 2-4 

H324 pushbutton panel, 2-4, 2-5 

M9301-YA, 2-5, 2-6 

M9301-YB, 2-5, 2-6 

M9301-YC, 2-6, 2-7 

M9301-YF, 2-7 

M9312, 2-8, 2-11 

MRll-DB, 2-5 
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BP2C0M Run-Time System 

select for BUILD, 6-15 
BUFF.SYS system file, 3-46 

alter by CHANGE, 3-58 

create, 3-46 

create for DECtape, 3-51 

DEC tape requirement, 3-55, 3-56 

placement of, 3-51 
Buffer quota, 4-15 
Buffers 

guidelines for small, 4-14 
BUILD control files 

BUILD.CTL, D-1 

list of, 6-11, 6-13 
BUILD program, 1-5, 6-2, 6-3, D-1 

to add RMS-llK, 6-19 

to add RSX, 6-19 

applying patches, 6-5 

build additional files, 6-18 

build RSX Run-Time System, 6-7 to 6-9 

build SORT Utility Package, 6-19, 6-20 

build system library, 6-10, 6-11 

construct utility programs, 6-3 

control files, D-lt 

create logfile, 6-12 

create new system library, 7-3 

dialogue, 6-7 to 6-17 

invoke, 6-11 

logfile command, 6-12 

logfile command switches, 6-12 

must process BUILD.CTL, 6-11 

patch RSX Run-Time System, 6-8, 6-9 

patching procedures, 6-14 

RUN command for, 6-7 

run-time system error messages, 6-15, 6-16 

run-time system response, 6-15 
BUILD.CTL programs and files 

list of, D-2t, D-3t 
Bus Address Extension. See BAE 



C360, 4-8 
Cache, 3-86 

cluster size of, 3-86 

in HARDWR list, 3-33 

statistics, 4-15 
Cache cluster size 

affect throughput, 3-87 

considerations, 3-87 

setting, 3-86 
Call 360 BASIC Code. See C360 
CAN'T FIND FILE OR ACCOUNT message, 
3-98 



Card code 

ANSI standard, 4-11 

DEC026, 4-11 

DEC029, 4-11 

IBM 1401, 4-11 
Card reader, 4-11 

with non-standard vector, 3-28 

vector locations, 3-37 
Cassette tape drive 

TU58, 3-28 
CATALOG command, 4-20 
CCL command 

small buffer requirement, 4-15 
Central Processing Unit. See CPU 
CHANGE suboption, 3-54t, 3-57 

CTRL/C response to, 3-57 

example of, 3-58, 3-59 

questions in, 3-57t, 3-58t 
CIS 

in HARDWR LIST, 3-32 
CLEAN facility 

in REFRESH option, 3-46 
Clock 

KWll-L in HARDWR list, 3-32 

KWll-L Line Time, 3-88 

KWll-P in HARDWR list, 3-32 

KWll-P Programmable Real-Time, 3-88 
Cluster number 

add to BADB.SYS, 3-8 

for bad block, 3-8 

example of, 3-12, 3-13, 3-16 to 3-18 
Cluster size 

cache, 3-86, 3-87 

pack, 3-6 
COBOL compiler 

swap maximum range, 3-73 
COBOL language, 4-20 

add optional, 6-18 

add RMS-llK support, 6-18 

add RSX support, 6-18 
Code 

correct system, 5-1 

disk-handling, 4-19 

overlay, 4-19 

resident, 4-19 

send/receive, 4-19 

simple SYS call, 4-19 
Command 

ADD, 7-3 

ASSIGN, 3-87 

BOOT, 1-32 

buffer requirement for CCL, 4-15 

BUILD logfile, 6-12 

CATALOG, 4-20 

DEASSIGN, 3-96 
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Command, (cont.) 

DISMOUNT, 4-23 

LOGINS, 4-22 

MOUNT, 4-2, 6-2, 6-4, 7-2, 7-3 

NO LOGINS, 1-31, 4-23 

R SYSBAT, 4-22 

R to start CREATE.SAV, 4-2 

REMOVE, 4-23 

SHUTUP, 1-31, 4-23 

TTYSET, 3-103 
Command file, indirect 

in CRASH.CTL, 6-22 

in START.CTL, 6-22 
Commercial Instruction Set. See CIS 
Concise Command Language. See CCL 

command 
CONFIG.MAC file, 4-4 

SYSGEN builds, 4-22 
Configuration 

change, 1-3 

correct hardware, 1-16 

delete devices from, 3-43 

initialization code resets, 3-42 

list hardware, 1-16 

resetting, 3-38 

scan hardware, 3-45 
Configuration listing 

possible comments, 3-33t, 3-34t 
Configuration questions, 1-3, 4-1 

answer formats, l-22t, 4-3t 

answering system, 1-3, 4-3 

long form, 4-4 

possible responses to, l-23t, 4-4t 

short form, 4-4 

summary of, l-23t to l-31t 

SYSGEN.SAV, 1-4 
Configuration table 

devices remain in, 3-43 

hardware, 3-31 
Configuring system 

versus tailoring system, 1-3 
Console emulator 

M9312, 2-8 
Console keyboard 

lower-case capability, 3-75 
Console terminal, 1-2 

/DETACH from, 6-12 

enable only, 3-102 

fill characteristics, l-35t, 3-102, 3-103t 

keyboard number, 4-7 

set fill characteristics, 5-2 

on single-line interface, 4-7 

system, 4-7 



Control file 

BACKUP.CTL, 6-11, 6-13 

BIGPRG.CTL, 6-11, 6-13 

BUILD.CTL, 6-11, 6-13 

CRASH.CTL, 3-103 

create CRASH.CTL, 6-22 

create START.CTL, 6-22 

DEVTST.CTL, 6-11, 6-13 

SPLER.CTL, 6-11, 6-13 

START.CTL, 3-103, 6-24 

SYSGEN.CTL, 1-31 
Control files 

for BUILD program, D-lt 

list of BUILD, 6-11 

system library, 1-5, D-1 

verify system start-up, 6-25 
Control Status 3. See CSS 
Control Status Register. See CSR 
Controller 

disable with HARDWR, 3-95 

disabling device, 3-34 

DLll terminal interface, 3-40 

enable device, 3-35 

erroneously detected, 3-34 

list, 3-30 

maximum RSTS/E number, 3-30 

moving head disk, 4-10 

name, 3-30 

non-standard device, 3-37 

non-standard vector address, 3-37 

XBUF for DCMll, 3-86 

XBUF for KMCll, 3-86 
Controller address 

declaring non-standard, 3-36 
COPY option, 1-2, 1-15, 5-1 

/A response, 1-32, 3-21, 5-2 

automatic bootstrap, 1-15 

copy system disk, 1-3 

copy system files, 1-2, 1-15, 3-20 

copy Target system files, 1-32 

dialogue error messages, 3-21 

example of, 3-21 

files transferred by, 3-20 

summary of questions, l-15t, l-34t 

tailoring procedures in, 3-4 

tailoring Target system, 1-3 

for Target system, 5-2 

use of, 3-2t 
CPU, 2-1 

switches on, 2-1 
CPU ROM 

in M9312 Bootstrap, 2-8 
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CPU 'Switch Register 

control automatic restart, 3-42t 

DISABLE in SWITCH, 3-42t 

ENABLE in SWITCH, 3-42t 

in HARDWR list, 3-32 

Monitor Statistics Package, 3-42t 

set with HERTZ, 3-29 

specify characteristics of, 3-41 

VOLATILE in SWITCH, 3-42t 
Crash dump, 3-87 

change with START, 3-97 

enable, 3-52 

during parity error, 3-81 

reserved location, 3-37 

RSTS/E procedures, 3-51, 3-52 
CRASH.CTL control file 

create, 6-22 

indirect command files, 6-22 

set fill characteristics, 3-103 
CRASH.SYS system file, 3-46, 3-87 

alter by CHANGE, 3-58 

error log data from, 3-81 

maximum size of, 3-52 

minimum size, 3-56 

monitor memory in, 3-52 

necessary size of, 3-52 

planning, 3-51 

prevent data loss, 3-52 

size considerations, 3-52 

space to allocate, 3-52 

STAF^T checks, 3-99 

on system disk, 3-51 
CREATE batch stream, 7-2 
CREATE.LOG file 

CREATE.SAV log file, 4-3 
CREATE. SAV program, 1-22, 4-1, 4-5, 4-22 

copies Target system files, 4-2 

includes batch stream, 4-1 

R command for, 1-22 

start, 4-2 
CREF.SAV file, 4-2, 4-3 

cross reference table, 4-3 

for on-line generation, 7-2 
CS3 

address, C-8 
CSR, 3-27 
CSR set, 3-27 

device controller, 3-36 

non-standard, 3-38 
CSR settings, 3-28 
CSR suboption 

CTRL/Z response in, 3-36 

example of, 3-36 



CSR suboption, (cont.) 

in HARDWR option, 3-27 

invoke, 3-36 

invoke controller list, 3-29 

non-standard address, 3-36 

non-standard device controller, 3-37 

REMOVE response in, 3-36 

? response to, 3-30 

use of, 3-27, 3-28, 3-36 
CTG File Flag, 3-55t, 3-56 
CTRL/C 

from HARDWR suboption, l-16t 
CTRL/0 response, 3-54 

in PATCPY program, 6-6 
CTRL/Z response 

in CSR suboption, 3-36 

in DM suboption, 3-40 

in DSKINT option, 3-7 

in HARDWR suboption, 3-30 
Current Size column 

in file status table, 3-56 



Data caching, 3-86. See also Cache 

install, 3-86 
Data caching module 

extended buffer space, 3-84 
Data set, 4-8 
Date 

last accessed, 3-6 

last changed, 3-6 
Date format 

alphabetic, 3-89 

numeric, 3-89 

specifying, 3-89 
DCll single line interface, 4-8 
DEASSIGN command, 3-96 
DEC026 card code, 4-11 
DEC029 card code, 4-11 
DECnet/E 

distribution media, l-12t 

extended buffer space, 3-84 

network support, 4-11 

separate distribution, 4-11 

use of buffer space, 3-85 
DECtape 

create BUFF,SYS for, 3-51 
DEFAULT option, 1-2, 3-97 

default run-time system, 7-3 

dialogue error messages, 3-90t, 3-91t 

EXIT response, 1-20 

install BASIC-PLUS-2, 6-25 
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DEFAULT option, (cont.) 

invoke, 3-72 

monitor defaults, 3-44 

set system defaults, 1-2, 1-4 

setting job maximum, 3-72 

specify installation name, 3-75 

summary of questions, l-20t, l-38t, 
l-39t, l-41t, l-42t 

summary of suboptions, l-20t, l-39t, 
l-41t, l-42t 

tailoring procedures in, 3-4 

tailoring Target system, 1-4 

for Target system, 5-3 

use of, 3-2t, 3-72 
Delay factor 

before restart, 3-90 
DELETE FILES question, 4-5, 7-2 
/DETACH switch 

for BUILD command, 6-12 
Device characteristics 

SET option, 1-2 
Device cluster size 

requirements of, 3-6 
Device codes 

for M9301-YF Bootstrap, 2-7 
Device controller 

disable, 3-34 

enable, 3-35 

non-standard vector address, 3-37 
Devices 

use of peripheral, 4-10 
DEVTST Package 

in BUILD, 6-17 
DEVTST.CTL control file, 6-11, 6-13, D-lt 

programs, D-6t 
DHll terminal interface multiplexer, 3-28, 

3-39, 3-40, 3-93, 4-7, 4-8, C-1 
DHll terminal multiplexer, 3-28 
Directory 

pre-extend, 3-7 

statistics, 4-15 
DISABLE CACHE command 

control FIP buffering, 4-17 
DISABLE response 

in SWITCH suboption, 3-42t 
DISABLE suboption in HARDWR 

controller list, 3-29 

device controller, 3-27 

example of, 3-34, 3-35 

non-standard device, 3-34 

? response to, 3-30 

use of, 3-28t, 3-34 
DISABLE suboption in SET, 3-91t 

example of, 3-95 

use of, 3-95 



Disk 
bad blocks on fixed head, 3-49 
bootstrap distribution medium, 2-2 
clean in BADS suboption, 3-61 
clean with REFRESH, 3-52, 3-53 
device sizes, B-lt 
disabled, 3-42 
distribution media, 1-llt 
dual-ported, 3-43 
example of initializing, 3-11, 3-12 
fixed head, 3-48 
fixed system, 4-9 
formatting, 3-5, 3-7 
generated system on, 4-5 
initialize, 1-3, 3-5, 3-7 
initialize non-file structured, 3-18 
initialize nonsystem, 3-16 
initialize RK06, 3-16 
initialize RS04, 3-19 
initialize SYSGEN, 1-13 
initialize Target, 1-13 
intermediate, 6-2 
intermediate Target system, 1-32 
messages during formatting, 3-7 
mount procedures, 6-3, 6-4 
moving head, 3-7 
moving head fixed, 4-10 
nonsystem, 4-9 
optimize, 3-6, 3-7 
overhead, 4-10 
pattern checks on, 3-5 
private, 3-6, 4-9 
public, 3-6, 4-9 

REFRESH clean operation, 3-52, 3-53 
removable system, 4-9 
statistics, 4-15 

swapping files on moving head, 3-50 
swapping space on fixed head, 3-49 
SYSGEN, 6-2 
system, 4-9 

system files on nonsystem, 3-55 
Target, 1-6, 6-1 
use of fixed head, 4-10 
use of moving head, 4-10 

Disk, auxiliary 

allocate ERR. SYS on, 3-46 

allocate OVR.SYS on, 3-46 
Disk driver phase 

considerations, 4-17 

increase monitor size, 4-17 

relocation, 4-17 
Disk-handling code 

make resident, 4-19 

summary of, 4-19 
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Diskette 

storage on, 4-10 
DISMOUNT command, 4-23 
Display Register 

in HARDWR list, 3-32 
Distribution medium, 1-3, 1-6, 2-1 

7-track magnetic tape, 1-2 

9-track magnetic tape, 1-2 

Autopatch, 6-2 

bootstrap, 2-1 

bootstrap disk, 1-13, 2-2 

bootstrap magnetic tape, 1-13, 2-2 

bootstrap RSTS/E, 1-12 

copy patches from Autopatch, 6-5 

DECnet/E, l-12t 

dismount RSX Run-Time System, 6-9 

dismount system library, 6-17 

files on, 4-2 

magnetic tape, 1-11 to 1-13 

math packages on, 4-20 

mount, 1-12, 1-13 

mount Autopatch, 6-5 

mount RSX, 6-7 

optional software, l-12t 

RJ2780, l-12t 

RK05, 1-2 

RK05 disk, 1-llt 

RK06, 1-2 

RK06 disk, 1-llt 

RK07, 1-2 

RK07 disk, 1-llt 

RLOl, 1-2 

RLOl disk, 1-llt 

RSTS/E, 1-2 

RSTS/E system library, 6-10 

store, 1-4, 6-25 

system programs on, 1-4 
DISTRIBUTION MEDIUM question, 4-5 
DJll multiplexer, 4-7 

floating address device, C-1 
DLll 

declare associations, 3-40 

terminal interface, 3-28 

terminal interface controller, 3-40 
DLll terminal interface, 4-7, 4-8 
DM suboption 

CTRL/Z response in, 3-40 

example of, 3-40 

use of, 3-28, 3-39, 3-40 
DMll-BB modem control multiplexer, 3-28, 

3-39, 3-40, 4-7, 4-8 
DMCll controller 

require XBUF space, 3-86 
DMCll interprocessor link, 4-11 

floating address device, C-1 



DPll synchronous line interface, 4-12 
DQll synchronous line interface, C-1 
DSKINT option, 1-2 

builds RSTS/E file structure, 3-8 

counts bad blocks, 3-8 

CTRL/Z response, 3-7 

dialogue error messages, 3-19 

dialogue questions in, 3-8t to 3-lOt 

example of, 3-11 to 3-13, 3-16 to 3-18 

initialize disk, 1-2, 1-32, 3-7, 5-2 

positions SATT.SYS, 3-7 

pre-extend directories, 3-7 

summary of questions, l-14t, l-15t, 
l-32t to l-34t 

tailoring procedures in, 3-4 

for Target system, 5-2 

use in REFRESH, 3-46 

use of, 3-2t 
DUll synchronous line interface, 4-12, C-1 
DUAL-PORTED question 

in UNITS subopiton, 3-43 
DUPll synchronous line interface, 4-12, C-1 
DZll multiplexer, 3-93, 4-7, 4-8 

floating address device, C-1 



EBCD, 4-8 

Echo control, 4-9 

ENABLE CACHE command 

control FIP buffering, 4-17 
ENABLE response 

in SWITCH suboption, 3-42t 
ENABLE suboption in HARDWR, 3-27 

controller list, 3-29 

device controller, 3-27 

example of, 3-35 

? response to, 3-30 

use of, 3-28t, 3-35 
ENABLE suboption in SET, 3-91t 

use of, 3-95 
END FORMAT PASS message, 3-7 
.ERR file 

in COPY option, 3-20 
ERR.ERR file 

transferred by COPY, 3-20 
ERR.STB file, 4-2, 4-3 

for on-line generation, 7-2 
ERR. SYS system file, 3-46 

allocate on auxiliary disk, 3-46 

alter by CHANGE, 3-58 

create, 3-46 

error message file in, 3-51 

on fixed head disk, 3-49, 3-51 
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ERR.SYS system file, (cont.) 
placement of, 3-51 
size of, 3-56 
ERRCPY program, 3-52 

inactive job, 3-50 
ERRDIS program, 3-82 

bad block number, 3-61 

report from, 3-81 
Error 

memory cache parity, 3-82 
Error message file, 1-6, 4-5 

not modify, 3-60 
Error message files 

default, 3-74 

designate, 3-74 

specify with DEFAULT, 3-75 
Error messages 

BATCH, A-15t 

in BOOT option, 3-lOOt 

in COPY option, 3-21t 

DEFAULT dialogue, 3-90t 

in DEFAULT option, 3-91t 

in DSKINT option, 3-19t 

in HARDWR option, 3-44t 

initialization code, 1-4, A-lt to A-13t 

in INSTALL option, 3-45t 

in LOAD option, 3-lOlt 

in PATCH option, 3-26t 

recoverable RTll, A-13t, A-14t 

in REFRESH option, 3-7 It 

RTll Run-Time System fatal execution, 1-5 

in SET option, 3-97t 

in START option, 3-99 
ESCAPE key 

configuration question response, l-23t, 4-4t 
Event-driven jobs, 3-48 to 3-50 
Extended Binary Coded Decimal. See EBCD 
Extended buffer pool 

allocate memory for, 3-75 
Extended buffer space, 3-84 

allocate no memory, 3-80 

amount to allocate, 3-84 

for data caching module, 3-84 

for DECnet/E, 3-84, 3-85 

for extended data buffering, 4-17 

FIP buffering, 4-16 

for FIP buffering, 3-84 

for KMCll support, 3-84 

for line printer driver, 3-84, 3-85 

for message send/receive code, 3-84, 3-85 

reserve memory for, 3-84 

for RSTS/2780, 3-84 

in solid-state memory, 3-83 

UNIBUS mapping registers, 3-85 

unlock memory, 3-82 



EXTENDED BUFFERING FOR LP question, 

4-11 
Extended data buffering, 4-17 
Extension 

.BAC for run-time system, 6-15 

file with .ERR, 3-20 

file with .RTS, 3-20 

file with .SAV, 3-20 

file with .SIL, 3-20 

.OBJ, 4-5 

.RTS for run-time system, 3-74 

.SAV, 3-100, 4-5 

.STB, 4-5 

.TMP, 3-53 

.TSK for run-time system, 6-15 



File 
added at beginning, 3-6 
added at end, 3-6 
allocate to bad block, 3-46 
attributes, 3-6 
batch control, 4-22 
BUFF.SYS swapping, 3-46 
change allocation of, 3-46 
changing characteristics in [0,1], 3-59 
CONFIG.MAC, 4-4 
Control Block, 4-13 
CRASH.SYS swapping, 3-46 
create, 3-46 

create start-up control, 6-20 
create system message, 6-20 
CREATE.LOG, 4-3 
CREF, 4-2, 4-3 
date last accessed, 3-6 
date last changed, 3-6 
delete, 3-46 
ERR.STB, 4-2, 4-3 
ERR.SYS, 3-46 
error message, 1-6 
examine bad block, 3-46 
expanding bad block, 3-61 
Flags, 3-55t 
HOOK, 4-2, 4-3 
LINK, 4-2, 4-3 
MACRO, 4-2, 4-3 
mark as deletable, 3-59 
mark as not deletable, 3-59 
MINCOP.BAS, 4-2 
monitor SIL, 3-46 
OVR.SYS, 3-46 
PIPSAV.TXT, 4-2 
plan crash dump, 3-51 
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File, (cont.) 
plan swapping, 3-47 
plan system, 3-46 
position SATT.SYS, 3-7 
REFRESH positions, 3-46 
RTll.RTS, 4-5 
SILUS, 4-2, 4-3 
size of swapping, 3-50 
structure, 3-5 
structure corrupt, 3-53 
SWAP.SYS swapping, 3-46 
SWAPO.SYS swapping, 3-46 
SWAPl.SYS swapping, 3-46 
SWAP3.SYS swapping, 3-46 
SYSGEN.CTL, 1-31, 4-4 
TECO, 4-2 
update bad block, 3-46 

File Processor Buffering. See FIP Buffering 

File status table 
account [0,1] in, 3-55 
determine CRASH.SYS size, 3-52 
entries in, 3-55t, 3-56t 
listing, 3-54 

FILE suboption, 3-54t 
example of, 3-60 
use of, 3-59 

Files 
delete system generation, 4-5 
distribution medium, 4-2 
establishing default, 3-74 
number of swapping, 3-48 
planning optional system, 3-51 
planning swapping, 3-48 

Fill 
characteristics, 1-34 
characters, 3-102 

Fill characteristics 
console terminal, l-35t 

FILL option, 1-2, 1-34 
tailoring procedures in, 3-4 
for Target system, 5-2 
use of, 3-3t, 3-102, 3-103 

FIP buffering 
commands to control, 4-17 
control with CACHE commands, 4-17 
directory caching, 4-17 
extended buffer space, 3-84 
module, 4-16 
optimize, 4-17 
recommended use of, 4-17 
use as cache, 4-16 
use of, 4-16 



FIS 

exception trap vector, 3-37 

floating point instructions, 4-20 

in HARDWR LIST, 3-32 
Fixed 

address devices, C-8 

addresses, 1-5 

vector devices, C-8 

vectors, 1-5 
Fixed head disk, 3-50, 3-51 

allocate swapping space, 3-49 

bad blocks on, 3-49 

non-file structured, 3-48 

OVR.SYS on, 3-49 

SWAPO.SYS on, 3-49 

for swapping files, 3-48, 3-49 

use DSKINT option, 3-48 

use of, 4-10 
Floating 

address, 1-5, C-1 

address devices, C-1, C-2 

address worksheet, C-2 to C-7 

vector, 1-5, C-1 

vector devices, C-1, C-7 
Floating address worksheet, C-6 
Floating Instruction Set. See FIS 
Floating point format 

double-precision, 4-20 

single-precision, 4-20 
Floating Point Processor. See FPP 
Flow chart 

system generation, 1-8, 1-9 
FORTRAN IV 

add optional, 6-18 

swap maximum range, 3-73 
Four-word math packages, 4-21t 
FPP 

exception trap vector, 3-37 

floating point instructions, 4-20 

in HARDWR, 3-32 



Generate 

RSTS/E Monitor, 1-4 
Generation 

of RSTS/E system, 1-1 
Global symbol name, 3-23 



H 

H324 pushbutton panel procedure, 2-4, 2-5 
Hardware 

bootstrap addresses, 2-3t 

bootstrap procedures, 2-2 
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Hardware, (cont.) 

loader, 1-2, 2-1 

messages, 3-98 

parity registers, 3-78 
Hardware configuration, 1-16, 3-27 

initialization code resets, 3-42 

monitor read/write area, 3-52 

table, 3-31 
HARDWR option, 1-2, 1-16, 1-34, 3-2t, 3-27 

bootstrap system disk, 3-27 

CTRL/C response, 3-29 

DISABLE suboption in, 3-27 

ENABLE suboption in, 3-27 

error messages, 3-44t 

EXIT response, 3-29 

invoke, 3-29 

LINE FEED response, 3-29 

LIST example, 3-31 

LIST suboption, 3-27 

messages in, 3-29 

summary of suboptions, l-16t, l-17t, 
l-35t, l-36t 

tailoring procedures in, 3-4 

for Target system, 5-2 
HARDWR suboption 

CTRL/Z response, 3-30 

EXIT response, l-16t 

initiate hardware scan, 3-27 

table, 3-28t 
HELP option, 3-3 
HELP.TXT system file 

create, 6-21 
HERTZ 

in HARDWR LIST, 3-32 
HERTZ suboption 

set AC line frequency, 3-41 

use of, 3-28t, 3-29, 3-41 
Hibernation state, 3-48 
HOOK file, 4-2, 4-3 
HOOK.SAV file 

for on-line generation, 7-2 



I 

IBM 
1401 card code, 4-11 
Correspondence Code, 4-8 
Protocol Emulator, 4-11 
Remote Batch Terminal, 4-12 

IDENTIFY function 
in SAVE/RESTORE, 3-103 

IMAGE function 
in SAVE/RESTORE, 3-103 



Indirect command files 

in CRASH.CTL, 6-22 

in START.CTL, 6-22 
INIT.BAC program, 3-98 

associate swapping files, 3-48 

enable swapping files, 3-51 

install swapping unit, 3-48 
INIT.SYS system file, 3-1 

determine vector, 3-37 

message, 3-27 

non-standard vector, 3-37 

not modify, 3-60 

patch, 1-6, 1-16, 3-22 

reboot system device, 3-28 

scan hardware configuration, 3-27 

transferred by COPY, 3-20 
Initialization 

disk, 3-5 

example of disk, 3-11, 3-12 

RS04 example of, 3-18, 3-19 

of SYSGEN system disk, 3-11, 3-12 
Initialization code 

bootstrap, 1-2 

configuration scan, 3-31 

dialogue interface with, 3-3 

disables devices, 1-22 

error messages, 1-4, A-lt to A-13t 

example of patching, 3-25 

incorrect vector address, 3-37 

interprets non-standard device, 3-34 

loaded into memory, 3-1 

long form question, 3-3 

message, 3-27 

OPTION prompt, 3-3 

options, 3-1 

patch, 3-24 

patch space in, 3-22 

positions SATT.SYS, 3-7 

prints default summary, 3-97 

prints job maximum, 3-74 

prints swap maximum, 3-74 

reboot after patch, 3-24 

resets configuration, 3-42 

short form question, 3-3 

stand-alone program, 3-1 

summary of options, 3-2 
Initialize 

disk, 1-3, 3-5 

disk for optimal performance, 3-6 

nonsystem disk, 3-16 

RK05F disk, 3-7 

SYSGEN system disk, 1-13, 3-7 

Target disk, 1-13 

Target system disk, 3-7 
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INSTALL option, 1-2, 1-36 

boot system disk, 3-45 

change monitor, 3-44 

delete monitor, 3-46 

dialogue error messages, 3-45t 

example of, 3-45 

initiate hardware scan, 3-27 

install Target monitor, 5-2 

scan configuration, 3-45 

tailoring procedures in, 3-4 

use of, 3-2t, 3-44, 3-45 

before using DEFAULT, 3-72 
Installation 

monitor, 1-2, 1-4, 3-44 

monitor SIL, 3-45, 3-46 

patch, 1-16 

SIL before DEFAULT, 3-72 

SYSGEN monitor, 1-18 

Target monitor, 1-3, 1-36, 5-1 
Installation name 

specify with DEFAULT, 3-75 
Interface 

DCll single line, 4-8 

DLllD single line, 4-8 

DLllE single line, 4-8 

error message, 4-8 

improper terminal, 4-7 

terminal, 4-7 
Interleaved 

memory, 3-79 

parity memory, 3-78 

RS03 disk, 3-43 

RS04 disk, 3-43 
Intermediate Target medium, 1-32, 1-42, 1-43 
INTERRUPT FREQUENCY question, 3-89 
Interrupt vectors, 1-5 



JOB MAX, 3-49, 3-50 
calculate file size, 3-58t 
printout of current, 3-74 

Job maximum, 3-72 
change with START, 3-97 
configured, 4-13 
default, 3-50, 4-13 
printout of current, 3-74 
setting, 3-72 

for SYSGEN system, 3-73 
for Target system, 3-73 

Jobs 
maximum number of, 4-13 
privileged, 3-96 



Key 

ESCAPE, l-23t, 4-4t 

LINE FEED, l-23t, 4-4t 

RETURN, l-23t, 4-4t 
Keyboard 

console, 1-2 

KBO:, 4-7 

master, 4-9 

monitor, 1-6, 3-74, 6-16 

number assignment, 4-7 

order assignment, 4-7 

pseudo, 1-2, 4-6 to 4-8, 4-22, 7- 
Kit 

Autopatch, 6-3 to 6-5 

optional software, 6-3 

system library, 6-3 
Kits 

system generation, 1-1 It 
KMCll 

controller, 3-86 

micro-processor, 4-12, C-1 

support package, 3-84 
KMC-11 micro-processor, 4-11 
KWll-L clock, 3-88 

in HARDWR LIST, 3-32 

reserved location, 3-37 
KWll-P clock, 3-88 

in HARDWR LIST, 3-32 

reserved location, 3-37 



Large File feature 

accurate file size, 4-13 

add during system generation, 4-13 

decrease directory searches, 4-13 

extend files, 4-13 

improve throughput, 4-13 

interlocked block checking, 4-13 
LINE FEED key 

configuration question response, l-23t, 4-4t 
Line printer 

buffer quota, 4-15 

case setting, 3-94 

change characteristics of, 3-93 

characteristics, 3-94t 

type of, 3-93 

width setting, 3-94 
Line printer driver 

buffer data, 4-11 

extended buffer space, 3-84, 3-85 

maximum XBUF used, 4-11 

require XBUF space, 3-86 
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LINK.SAV file, 4-2, 4-3 

for on-line generation, 7-2 
LIST suboption in DEFAULT, 3-76t, 3-78 

example of, 3-77, 3-80, 3-82, 3-84, 3-85 

prints memory allocation table, 3-77 
LIST suboption in HARDWR, 3-27, 3-28t 

example of, 3-31 

list configuration, 3-27 
LIST suboption in REFRESH, 3-54t 

example of, 3-54 

use of, 3-54 
LIST suboption in SET, 3-91t 

example of, 3-92 

use of, 3-92 
LKll link 

floating address device, C-1 
Load maps, 4-5, 4-6 
LOAD option 

dialogue error messages, 3-lOlt 

example of, 3-101 

use of, 3-2t, 3-100, 3-101 
Load program bootstrap 

for RK07, 2-12, 2-13 

for RLOl, 2-12, 2-13 

for RL02, 2-12, 2-13 

for TEIO, 2-14, 2-15 

for TS03, 2-14, 2-15 

for TUlO, 2-14, 2-15 
LOCAL suboption, 3-91t 
LOCK suboption, 3-76t 

error message, 3-81 

example of, 3-81 

use of, 3-80 
LOCKED symbol 

in Memory Allocation Table, 3-78t 
Logarithmic functions 

list of, 4-21 

omit, 4-21 
Logically mount 

disk distribution medium, 1-22 
LOGIN program, 4-2 
LOGINS command, 4-22 
LOGOUT program, 4-2 
LP FOR SYSGEN question, 4-5 
LP suboption, 3-91t 

example of, 3-94 

use of, 3-93 
.LST extension, 4-5 



M 

M9301-YA Bootstrap Terminator, 2-5, 2-6 

device codes, 2-6t 
M9301-YB Bootstrap Terminator, 2-5, 2-6 

device codes, 2-6t 



M9301-YC Bootstrap, 2-6, 2-7 

device codes, 2-6t 
M9301-YF Bootstrap Terminator, 2-7 

device codes, 2-7t 
M9312 Bootstrap Module, 2-8 
bootstrapping, 2-11, 2-12 

determine ROM configuration, 2-9, 2-10 

device mnemonics, 2-llt 

ROM addresses for, 2-lOt 

ROM arrangement for, 2-8t 

ROM locations, 2-lOt 

switch register codes, 2-12t 
M9312 console emulator, 2-8 

pushbutton boot, 2-9 

switch register boot, 2-9 

use of, 2-9 
MACRO. SAV file, 4-2, 4-3 

for on-line generation, 7-2 
Magnetic tape 

bootstrap distribution medium, 2-2 

distribution medium, 1-2, 1-1 It 

generated system on, 4-5 

labelling defaults for, 3-87 

mount procedures, 6-3, 6-4 

storage on, 4-10 
MAGTAPE LABELLING DEFAULT question 

responses, 3-88t 
Maintenance Examine/Deposit Instruction, 

3-32 
MAP suboption, 3-76t 

use of, 3-85 
Master File Directory, See MFD 
MAT statement 

in BASIC-PLUS, 4-21 
Math packages 

number of, 4t20 

two and four word, 4-2 It 
Matrix manipulation, 4-21 
Memory 

allocating, 3-75 

allocation, 3-80, 3-97 

allocation table, 3-75, 3-77 

assigning, 3-75 

cache area of, 3-86 

core, 3-79 

defective, 3-83 

ECC MOS, 3-79, 3-82 

error in monitor, 3-82 

existent, 3-75 

extended buffer pool, 3-80 

for extended buffer pool, 3-75 

failure, 3-81 

fast and slow, 3-83 

identify parity, 3-78 

interleaved, 3-78, 3-79, 3-81 



Index- 12 



Memory, (cont.) 

locate run-time system in, 3-83 

lock, 3-80, 3-81 

lock areas of, 3-75 

Management Unit trap vector, 3-37 

marked as nonexistent, 3-75 

monitor locks, 3-82 

nonparity, 3-78 

parity, 3-78, 3-79, 3-81, 3-82 

parity trap vector, 3-37 

recovery procedures, 3-81, 3-82 

release, 3-80 

remove bank of, 3-81 

reserve extended buffer space, 3-84 

run diagnostics, 3-82 

run-time system in low, 3-80 

solid-state, 3-83, 3-84 

types of, 3-78 

unlock, 3-82 

unlock areas of, 3-75 

USER, 3-85 

XBUF, 3-85 
Memory allocation table 

contents of, 3-77 

DEFAULT scans, 3-76 
Memory Allocation table 

INIT^SYS resets, 3-75 
Memory allocation table 

list, 3-77 

set up rules for, 3-80 

suboptions, 3-76t 

symbols in, 3-78t 
Message send/receive code 

extended buffer space, 3-84, 3-85 
MFD 

for account [1,1], 3-6' 

cluster size, 3-6 

pack cluster size in, 3-6 

RSTS/E file structure, 3-5 

storing files in, 6-14 

user accounts in, 6-23 
MINCOP program, 1-43, 6-1, 6-2 
MINCOP.BAS file, 4-2 
Minimum Size column 

in file status table, 3-56 
Modem 

control, 3-93 

null, 4-8 
MODEM suboption, 3-91t 

example of, 3-93 

use of, 3-93 
Module 

patch SIL, 3-23 
MODULE NAME question 

in PATCH option, 3-23 



Modules 

size of BASIC-PLUS, B-3t, B-4t 

size of system, B-2t, B-3t 
Monitor 

change, 3-44 

code in OVR.SYS, 3-51 

defaults set for, 3-72 

error, 3-82 

extended data buffering in, 4-17 

generate, 1-4, 4-6 

generate Target, 1-31 

install, 1-4, 3-44 

install SYSGEN, 1-18 

install Target, 1-3, 1-36 

keyboard, 1-6 

locks memory, 3-82 

logs error, 3-82 

memory in CRASH.SYS, 3-52 

memory parity error, 3-52 

name in SYSGEN system, 3-44 

name in Target system, 3-45 

no locking memory in, 3-81 

patch example, 3-24 

patch with INIT.SYS, 1-6 

patch with ONLPAT, 1-6 

read/write area of, 3-52 

Save Image Library, 1-6, 3-27, 3-44, 3-60 

tailor new, 7-3 

Target, 1-32, 1-34, 3-47 

Monitor code 
settings in, 1-3 

Monitor Statistics Gathering Package, 
3-42t, 4-15 

Mount 
distribution medium, 1-12, 1-13, 6-3, 6-4 
logically, 1-22 

MOUNT command, 6-2, 6-4, 7-2, 7-3 
distribution medium, 1-22 
logically mount disk, 4-2 
for Target medium, 1-43 

Moving-head disk, 3-7 
swapping files on, 3-50 
use of, 4-10 

MRll-DB Bulk Storage Loader, 2-5 

Multiple 

line printer, 4-11 

terminal service, 4-9 

Multiplexer 
considerations, 4-7 

DHll, 3-39, 3-40, 3-93, 4-7, 4-8, C-1 
DJll, 4-7, C-1 

DMll-BB modem control, 3-39, 3-40, 4-7 
DZll, 3-93, 4-7, 4-8, C-1 
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N 

New files 

added, 3-6 
NEW FILES FIRST question 

in DSKINT option, 3-lOt 
NO LOGINS command, 1-31, 4-23 
NOD File Flag, 3-55t, 3-56 
Non-existent devices, 1-22 
Non-file structured disk 

initialize, 3-18 

pattern checks on, 3-18 
Non-standard 

controller address, 3-36 

CSR set, 3-38 

device, 3-34 

device controller, 3-37 

hardware configuration, 1-2 

UNIBUS address, 3-37 

vector, 3-28, 3-37 

vector address, 3-32, 3-37 
Non-standard device, 3-34 
Nonparity memory, 3-78 
Nonsystem disk 

initialize, 3-16 

system files optional on, 3-55 
NOTICE.TXT system message file 

create, 6-20 
NULL characters, 3-102 
Null device, 3-96 
NXM symbol 

in Memory Allocation Table, 3-78t 



.OBJ extension, 4-5 

Octal word values, 3-5 

ODD TRANSFER ADDRESS question, 3-101 

Offset address, 3-23 

OFFSET ADDRESS question 

in PATCH option, 3-23 
ONLPAT program, 4-2, 4-5 

patch monitor with, 1-6 

patch system code, 4-6 
OPEN statement 

contiguous mode switch, 3-47 
OPSER program, 4-19 

inactive job, 3-50 
Option 

COPY, 1-2 

DEFAULT, 1-2 

DSKINT, 1-2 

error messages in BOOT, 3-lOOt 

error messages in DEFAULT, 3-90t, 3-91t 

error messages in LOAD, 3-lOlt 



Option, (cont.) 

error messages in SET, 3-97t 

error messages in START, 3-99 

example of BOOT, 3-100 

example of HELP, 3-3 

example of INSTALL, 3-45 

example of LOAD, 3-101 

example of REFRESH, 3-62 to 3-69 

example of START, 3-98 

example of UNISYS, 3-102 

FILL, 1-2 

HARDWR, 1-2 

INSTALL, 1-2 

PATCH, 1-2 

questions in REFRESH, 3-53t 

REFRESH, 1-2 

SET, 1-2 

START, 1-2 

suboptions in DEFAULT, l-20t, l-21t 

suboptions in REFRESH, l-18t, l-19t 

suboptions in SET, l-40t, l-41t 

summary of COPY, l-34t 

summary of DEFAULT, l-20t, l-38t, l-39t, 
l-41t, l-42t 

summary of DSKINT, l-32t to l-34t 

summary of REFRESH, l-36t to l-38t 

tailoring procedures, 3-4 

use of BOOT, 3-2t, 3-99, 3-100, 5-1 

use of COPY, 1-32, 3-2t 

use of DEFAULT, 3-2t, 3-72 

use of DSKINT, 1-32, 3-2t 

use of FILL, 1-34, 3-3t, 3-102, 3-103 

use of HARDWR, 1-16, 1-34, 3-2t 

use of HELP, 3-3t 

use of INSTALL, 1-36, 3-2t, 3-44 to 3-46 

use of LOAD, 3-2t, 3-l€0, 3-101 

use of PATCH, 3-2t, 3-22 

use of REFRESH, 3-2t, 3-46, 3-52, 3-60 

use of SAVRES, 3-3t, 3-103, 3-104 

use of SET, 3-2t, 3-91, 3-92 

use of START, 3-2t, 3-97 to 3-99 

use of UNISYS, 3-3t, 3-102 
OPTION prompt, 3-3 
Optional software 

add, 6-18 

build, 6-20 

building, 1-4 
Overlapped seek 

driver, 4-10 
Overlay code 
patch, 3-22 
OVR.SYS system file, 3-46, 3-51 
alter by CHANGE, 3-58 
on fixed head disk, 3-49, 3-51 
minimum size, 3-56 
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Pack cluster size, 3-6 
Pack ID 

PATCHA, 1-llt 

RMSKIT, 1-llt 

RSXLBB, 1-llt 

SYSGNG, 1-llt 

SYSLIG, 1-llt 

SYSL2G, 1-llt 
Paper tape 

punch, 4-15 

reader, 3-37 

storage on, 4-10 
Parity 

error, 3-79, 3-81, 3-82 

register, 3-78, 3-79 

type codes, 3-79t 
Parity memory, 3-78, 3-79 

log parity errors, 3-81 
PARITY suboption, 3-76t 

as diagnostic tool, 3-78 

example of, 3-78 

use of, 3-78 
Patch, 3-22 

BASIC-PLUS, 3-23 

during BUILD operation, 6-14 

example of monitor, 3-24 

initialization code, 1-16, 3-24, 3-25 

RTll Run-Time System, 1-16 

Save Image Library file, 3-23 

sources, 6-14 

standard system library, 6-4 

SYSGEN monitor, 1-16 

system code, 4-6 
PATCH option, 1-2, 1-16 

BASE ADDRESS question, 3-23 

correct code, 1-2, 3-22, 5-2 

error messages, 3-26t 

example of, 3-24, 3-25 

invoke, 3-22 

MODULE NAME question, 3-23 

OFFSET ADDRESS question, 3-23 

patch account [0,1], 3-22 

possible input to, 3-23t 

response in, 3-23t 

tailoring procedures in, 3-4 

use of, 3-2t, 3-22 
Patches 

in-place, 3-22 

install, 1-16 

manually apply, 1-6 
PATCPY program 

dialogue, 6-5, 6-6 

transfer patches, 6-4, 6-5 



Pattern checks, 3-5 

bad blocks during, 3-12, 3-13 

on non-file structured disk, 3-18 
Patterns 

used by DIGITAL, 3-5 
PATTERNS question 

in DSKINT option, 3-llt 
Peripheral devices 

use of, 4-10 
PIP.SAV program, 4-2, 4-5, 4-20, 4-23 

create ACCT.SYS, 6-23 

create HELP.TXT, 6-21 

create message files, 6-20 

create NOTICE.TXT, 6-21 

create start-up files, 6-20 

for on-line generation, 7-2 

optional software requires, 6-18 

transfer account [0,1] files, 3-60 
PIPSAV.TXT file, 4-2 
PIRQ trap vector 

reserved location, 3-37 
Power failure 

cause of, 3-89 

recovery from, 3-89 

RSTS/E encounters, 3-42t 
Pre-extend directories, 3-7 
PRE-EXTEND DIRECTORIES question 

in DSKINT, 3-9t 
PRINT USING, 4-20, 4-21 

patch, 3-23 
PRIV suboption, 3-91t 

example of, 3-96 

use of, 3-96 
Private disk, 3-6 
Privileged 

jobs, 3-96 

protection code, 6-23 
Processor Handbook 

switches described in, 2-3 
Program 

ANALYS, 3-81, 3-82 

BATCH, 4-19, A-14 

BUILD, 1-5, 6-2, 6-3, 6-5, 6-10, 6-11, 
7-3, D-1 

CREATE. SAV, 1-22, 4-1, 4-2, 4-5, 4-22 

dialogue for BUILD, 6-7 to 6-17 

ERRCPY, 3-50 

ERRDIS, 3-61, 3-81, 3-82 

example of REACT, 6-23 

example of SYSGEN.SAV, 7-2 

INIT.BAC, 3-98 

INIT.SYS, 3-1 

loading stand-alone, 3-100 

LOGIN, 4-2 

LOGOUT, 4-2 
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MINCOP, 1-43, 6-1, 6-2 

ONLPAT, 4-2, 4-5, 4-6 

OPSER, 4-19 

PATCPY, 6-4 to 6-6 

PIP, 4-2 

PIP.SAV, 3-60, 4-2, 4-5, 4-20, 4-23, 
6-20, 6-21 

QUEMAN, 3-50, 4-19 

REACT, 6-23, 6-24 

RJ2780, 4-19 

SAVE/RESTORE, 1-3, 3-103 to 3-104, 6-25 

shut down with UTILTY, 4-23 

SHUTUP, 6-24 

stand-alone, 3-1, 3-20 

SYSBAT, 1-4, 4-1, 4-6, 4-15, 4-22, 7-3 

SYSGEN, 1-4, 1-22, 4-2 

UTILTY, 1-4, 1-31, 4-2, 4-17, 4-22, 6-9, 
6-10, 6-17, 6-18, 7-2, 7-3 
PROGRAM LOST - SORRY message, 3-98 
Protocol Emulator 

IBM, 4-11 

RSTS/E 3271, 4-11, 4-12 
Pseudo keyboard, 1-2, 4-6 

always generated, 4-7, 4-8 

batch process on, 4-22 

CREATE.SAV logs into, 4-2 

maximum number, 4-8 

number assignment, 4-7 

for on-line generation, 7-1 
PUB, PRI, OR SYS question 

in DSKINT option, 3-9t 
Public 

disk, 3-6 



Q 



QUEMAN program, 4-19 
inactive job, 3-50 



R command 

for CREATE.SAV, 1-22, 4-2 

for SYSBAT, 1-31, 4-22 

UTILTY.SAV, 1-31 
REACT program, 6-24 

create user accounts, 6-23 

example of, 6-23 
Receive Interrupt feature, 4-8 
Recoverable error 

example of, 3-12, 3-13 

during pattern checks, 3-8 



Recovery media, 1-4 

create with SAVE/RESTORE, 3-104, 6-25 

store, 1-4 
REFRESH option, 1-2, 1-18, 1-36, 3-52 

allocate files, 1-2, 1-36 

bad block file, 3-46 
,^clean, 3-46, 3-52, 3-53 

correct CRASH.SYS, 3-87 

create SWAP.SYS only, 3-47 

delete default RTS, 7-3 

delete file using, 3-56 

dialogue error messages, 3-71t 

example, 3-62 to 3-69 

EXIT response, 3-54 

LINE FEED response, 3-54 

questions, l-18t, l-36t, l-37t, 3-53t 

SATT.SYS, 3-46, 3-52 

suboptions, l-18t, l-19t, l-37t, 3-54t 

summary of suboptions, l-38t 

tailoring procedures in, 3-4 

tailoring Target system, 1-4 

for Target system, 5-3 

use of, 3-2t, 3-46, 3-60 
Register 

parity, 3-78, 3-79 

UNIBUS mapping, 3-85, 3-86 
Release Notes 

RSTS/E, 1-6 

RSTS/E code corrections, 3-22 
REMOVE command, 4-23 
REMOVE response 

in CSR suboption, 3-36 

in UNITS suboption, 3-43 

in VECTOR suboption, 3-37 

in XBUF suboption, 3-85 
Reserved locations 

RSTS/E, 3-37 
RESET suboption in DEFAULT, 3-76t 

example of, 3-80 

memory allocation, 3-80 

use of, 3-80 
RESET suboption in HARDWR 

example of, 3-38, 3-39 

hardware scan, 3-27 

use of, 3-28t, 3-38 
Resident 

code, 4-19 

library, 4-17, 4-18 
RESTORE function 

in SAVE/RESTORE, 3-103 
RETURN key 

configuration question response, l-23t, 4-4t 
RH70 High Speed I/O Controller address, 
C-8 
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RJ2780 

distribution media, l-12t 

program, 4-19 
RK05 disk, 4-10 

distribution medium, 1-2, 1-1 It 

initialize, 3-7 

must format, 3-5 
RK06 disk 

can be formatted, 3-5 

distribution medium, 1-2, 1-1 It 

DSKINT example, 3-16 
RK07 disk 

can be formatted, 3-5 

distribution medium, 1-2, 1-llt 

load program bootstrap, 2-12, 2-13 

manual load, 2-8 
RK611 controller 

disabling, 3-27 
RK711 controller 

disabling, 3-27 
RLOl disk 

cannot be formatted, 3-5 

distribution medium, 1-2, 1-llt 

load program bootstrap, 2-12, 2-13 

system disk example, 3-66 
RL02 disk 

cannot be formatted, 3-5 

load program bootstrap, 2-12, 2-13 
RM02 disk 

can be formatted, 3-5 
RM03 disk 

can be formatted, 3-5 

for swapping, 4-10 
RMS-llK 

Resident Library, 4-18, 4-19 

support, 6-18, 6-19 
RMS accounts 

number of files in, 3-6 
ROM 

address for M9312, 2-lOt 

arrangement for M9312, 2~8t 

configuration, 2-8 to 2-10 

location for M9312, 2-lOt 
RP02 disk 

must format, 3-5 
RP03 disk 

must format, 3-5 
RP04 disk 

must format, 3-5 

system disk example, 3-62 
RP05 disk 

must format, 3-5 
RP06 disk 

must format, 3-5 



RPll controller 

FORMAT ENABLE/NORMAL switch, 
3-7, 3-8 
RPG II language, 4-20 

add optional, 6-18 

add RMS-llK support, 6-18 

add RSX support, 6-18 
RS03 disk 

interleaved, 3-43 

RS04 disk 

initialize, 3-18, 3-19 

interleaved, 3-43 

in REFRESH example, 3-62 
RSTS/2780 package, 4-12 

extended buffer space, 3-84 
RSTS/E 

3271 Protocol Emulator, 4-12 

buffer requirements, 4-14 

COBOL compiler, 3-73 

crash dump procedures, 3-51, 3-52 

disables cache, 3-82 

distribution medium, 1-2 

encounters power fail, 3-42t 

Error Package, 6-16 

file structure, 1-6 

generate for another computer, 4-4 

generate for same computer, 4-4 

halt location, 3-82 

keyboard monitor requirement, 1-6 

libraries, 6-2 

memory sizes of modules, B-2 

Monitor code, 1-3 

optional software distribution media, l-12t 

Release Notes, 1-6, 1-16, 3-22 

reserved locations, 3-37 

run-time system defaults, 1-6 

running with memory failures, 3-81 

Software Dispatch, 1-6, 1-16, 3-22 

start, 3-97 

system disk content, 1-6 

system files copied, 1-15 

system generation kits, 1-llt 

system library, 6-2 

system library control files, 1-5, D-1 

Target Monitor, 1-3 

Target system, 1-3 

terminal assignments, 4-7 

utility programs, 6-2 

RSTS/E file structure, 1-6 
bootstrap block, 3-5 
DSKINT builds, 3-8 
Master File Directory, 3-5 
minimal, 3-5 
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RSTS/E Monitor 

in CRASH.SYS, 3-52 

device controllers in, 1-3 

effects system file size, 3-56 

file required for, 3-55 

files required for, 4-3 

generate, 1-4, 7-1, 7-3 

generate SIL for, 4-22 

patch space in, 3-22 

RSX emulator code in, 4-18 

SIL, 5-2 

SIL name, 4-6 

support stand-alone program, 3-100 
RSTS/E system code 

patch, 3-22 
RSX 

directives, 4-18 

distribution medium, 6-7 

emulator code, 4-18 
RSX AS DEFAULT RTSjiuestion 

responses to, 4-6 
RSX Run-Time System 

add as default RTS, 6-19 

as default, 1-3, 1-6, 4-6, 6-7 

build, 6-8 

BUILD system default, 6-3 

BUILD utility programs, 6-3 

command level prompt, 6-1 

dismount distribution medium, 6-9 

emulator for, 4-18 

memory placement, 3-83 

memory requirement, 4-6 

patch, 1-3, 6-8 

select for BUILD, 6-15 

shut down, 6-24 

utility programs, 6-9 
RTll Run-Time System 

default for SYSGEN system, 1-6 

error messages, A-13t, A-14t 

for on-line generation, 7-1 

optional software requires, 6-18 

patch, 1-16 

special program versions, 4-2 

in SYSGEN system, 3-74 
RTll.RTS file, 4-5 

transferred by COPY, 3-20 
.RTS extension, 3-74 

file with, 3-20 
.RTS file 

in COPY option, 3-20 

patch, 3-22 
RTS suboption, 3-76t 

example of, 3-83 

use of, 3-83 



RTS symbol 

in Memory Allocation Table, 3-78t 
Run-time system 

auxiliary, 1-4, 4-15, 6-18 

BUILD error messages for, 6-15, 6-16 

change, 1-4 

default, 1-6, 1-31, 3-60, 3-74, 3-83, 
6-7, 6-24 

delete obsolete files, 3-59 

generate additional, 7-1 

locate in low memory, 3-80 

locking memory for, 3-81 

patch space in, 3-22 

prepare for new, 7-3 

RSX as default, 5-3 

in solid state memory, 3-84 

system default, 1-4, 1-6 
Run-time system, default, 1-6 

BASIC-PLUS-2, 6-25 

BASIC-PLUS-2 as, 6-7 

BASIC-PLUS as, 6-7, 7-3 

BP2C0M, 6-15 

delete with REFRESH, 7-3 

generate, 1-31 

install, 7-3 

RSX as, 6-7, 6-15, 6-19 

specify, 6-24 

use DEFAULT option, 7-3 



S ATT. SYS BASE question 

in DSKINT option, 3-9t 
SATT.SYS file 

position, 3-6, 3-7 

REFRESH builds, 3-46, 3-52 
.SAV extension, 3-100, 4-5 

file with, 3-20 
SAVE function 

in SAVE/RESTORE, 3-103 
Save Image Library. See SIL 
SAVE Set 

boot from, 3-104 
SAVE/RESTORE functions 

definitions of, 3-103 
SAVE/RESTORE program, 3-103 

copy system disk, 3-104 

create recovery media, 6-25 

functions, 3-103 

use of, 3-103, 3-104 
SAVRES option 

in SAVE/RESTORE, 3-3t 
SBCD, 4-8 
Scaled arithmetic, 4-20 
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Scan 

bottom up, 3-48 

top down, 3-48 
Send/receive code, 4-19 

make resident, 4-19 

SET option, 1-2, 1-20, 1-40 
error messages, 3-97t 
suboptions, 1 -21t, l-40t, l-41t, 3-91t 
tailoring procedures in, 3-4 
tailoring Target system, 1-4 
for Target system, 5-3 
use of, 3-2t, 3-91, 3-92, 4-7 

Shut down 

system, 1-3, 1-4, 1-31, 6-24 
Shut down system 

BASIC-PLUS, 6-24 

BASIC-PLUS-2, 6-24 

RSX, 6-24 
SHUTUP command, 1-31, 4-23 
SHUTUP program 

invoke, 6-24 

SIL 

designate monitor, 3-44 

generate RSTS/E Monitor, 4-22 

module, 3-23 

monitor, 1-6, 3-20 
.SIL extension 

file with, 3-20 

.SIL me 

in COPY option, 3-20 

patch, 3-22 
SILUS.SAV file, 4-2, 4-3 

for on-line generation, 7-2 
SIZE OF MAPPED XBUF question, 3-85 
SLEEP state, 3-48 
Small buffer pool 

FIP buffering uses, 4-16 

reduce impact on, 4-11 
Small buffers, 4-16 

compute number of, 4-14, 4-15 

formula for, 4-14 

guidelines for, 4-14 

use of, 4-14 

Software 

add optional, 6-18 

build optional, 6-20 

messages at start-up, 3-99 
Software configuration 

monitor read/write area, 3-52 

Software Dispatch 
RSTS/E, 1-6, 3-22 



Solid-state memory 

extended buffer space in, 3-83 

run-time system in, 3-83, 3-84 

systems without, 3-83 
SORT Utility Package 

build, 6-19, 6-20 

resident library, 6-20 

RSX emulator, 6-20 
SPLER.CTL 

control file, 6-11, 6-13, D-lt 

programs and files, D-4t 
SPOOLING Package 

in BUILD, 6-17 
Stand-alone program 

loading, 3-100 

with .SAV extension, 3-20 
Standard account file 

create ACCT.SYS, 6-23 
Standard Binary Coded Decimal. See SBCD 
Standard system library 

in account [1,2], 6-11 

build, 6-10 

definition of, 6-11 

distribution medium, 6-10 

mount, 6-11 
START FORMAT PASS message, 3-7 
START option, 1-2, 1-41 

error messages, 3-99 

example of, 3-98 

hardware messages, 3-98 

LINE FEED response, 3-97 

software messages, 3-99 

start SYSGEN system, 1-22 

start time sharing, 1-4, 7-3 

tailoring procedures in, 3-4 

tailoring Target system, 1-4 

for Target system, 5-3 

use of, 3-2t, 3-97 to 3-99 
Start time sharing, 1-4 
Start-up control files 

create, 6-20 

verify system, 6-25 
START.CTL control file, 3-103, 6-24 

create, 6-22 

indirect command files, 6-22 
Statistics 

cache, 4-15 

directory, 4-15 

disk, 4-15 

reserved location, 3-37 
.STB extension, 4-5 

Storage Allocation Table. See SATT.SYS file 
String arithmetic 

functions, 4-22 
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Suboption 

BADS, 3-54t, 3-61, 3-62 

CHANGE, 3-54t, 3-57 to 3-59 

CSR, 3-28t, 3-36 

DEFAULT LIST, 3-76t, 3-77, 3-80, 3-82, 
3-84, 3-85 

DEFAULT RESET, 3-76t, 3-80 

DM, 3-28, 3-39, 3-40 

FILE, 3-54t, 3-59, 3-60 

HARDWR DISABLE, 3-28t, 3-34, 3-35 

HARDWR ENABLE, 3-28t, 3-35 

HARDWR LIST, 3-28t, 3-31 

HARDWR RESET, 3-28, 3-38, 3-39 

HERTZ, 3-28t, 3-29, 3-41 

LOCAL, 3-91t 

LOCK, 3-76t, 3-80 to 3-82 

LP, 3-91t, 3-93, 3-94 

MAP, 3-76t, 3-85, 3-86 

MODEM, 3-91t, 3-93 

PARITY, 3-76t, 3-78 

PRIV, 3-91t, 3-96 

REFRESH LIST, 3-54t 

RTS, 3-76t, 3-83 

SET DISABLE, 3-91t, 3-95 

SET ENABLE, 3-91t, 3-95 

SET LIST, 3-91t, 3-92 

SWITCH, 3-28t, 3-41, 3-42t 

TU58, 3-28, 3-40, 3-41 

UNITS, 3-28t, 3-42, 3-43 

UNLOCK, 3-76t, 3-82, 3-83 

UNPRIV, 3-91t, 3-96 

VECTOR, 3-28, 3-37, 3-38 

XBUF, 3-76t, 3-84, 3-85 
Suboptions 

in DEFAULT option, l-20t, l-21t, l-39t, 
l-41t, l-42t, 3-76t 

in HARDWR option, l-16t, l-17t, l-35t, 
l-36t 

in REFRESH option, l-18t, l-19t, 3-54t 

in SET option, l-40t, l-41t, 3-91t 
Summary 

system generation process, 1-6 
Swap file 

compute number of jobs, 3-73 
Swap file scanning, 3-49f 
SWAP MAX, 3-50, 3-73 

calculate file size, 3-58t 

calculating SWAP. SYS size, 3-56 

printout of current, 3-74 
Swap maximum 
change with START, 3-97 
definition, 3-73 
example of setting, 3-74 
printout of current, 3-74 



SWAP maximum, (cont.) 
setting, 3-72 
for SYSGEN system, 3-73 
for Target system, 3-73 
SWAP. SYS system file, 3-46, 3-50, 3-73 
alter by CHANGE, 3-58 
configuration considerations, 3-48 
create, 3-46 
minimum size of, 3-56 
START checks, 3-99 
on system disk, 3-49, 3-55 
SWAPO.SYS system file, 3-46, 3-50 
alter by CHANGE, 3-58 
on auxiliary disk, 3-49 
SWAPl.SYS system file, 3-46 

alter by CHANGE, 3-58 
SWAP3.SYS system file, 3-46, 3-50 

alter by CHANGE, 3-58 
Swapping file, 1-6 
associate with INIT.SYS program, 3-48 
associate with UTILTY program, 3-48 
BUFF.SYS, 3-46 
considerations, 3-47 
contiguous space requirement, 3-47 
CRASH.SYS, 3-46 
create contiguous, 3-47 
ERR.SYS, 3-46 
on fixed head disk, 3-48 
fragmentation of, 3-47 
minimum size of SWAP.SYS, 3-56 
on moving head disk, 3-50 
name convention, 3-48 
number of jobs in, 3-50 
OVR.SYS, 3-46 
plan, 3-47, 3-48 
platter boundries, 3-48 
size of, 3-50, 3-73 
SWAP.SYS, 3-46 

SWAP.SYS altered by CHANGE, 3-58 
SWAPO.SYS, 3-46 

SWAPO.SYS altered by CHANGE, 3-58 
SWAPl.SYS, 3-46 
SWAP3.SYS, 3-46 

SWAP3.SYS altered by CHANGE, 3-58 
Swapping slots, 3-48 
Switch register 
CPU, 3-41 

set characteristics for, 3-41 
Switch Register Codes, 2-12t 
SWITCH suboption 
characteristics for recovery, 3-41 
DISABLE response in, 3-41 
ENABLE response in, 3-41 
responses, 3-42t 
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SWITCH suboption, (cont.) 

use of, 3-28t, 3-41 

VOLATILE response in, 3-41 
Switches 

list of BUILD command, 6-12 
Symbol name 

global, 3-23 
Symbol table, 3-23 
SYS calls, 4-19 
SYSBAT 

batch process, 1-31, 5-1 

for on-line generation, 7-2 

program, 4-6, 4-11, 4-22, 7-3 
SYSBAT program, 1-4, 4-1 
SYSGEN disk, 1-6, 1-13, 6-2 

copy system files to, 1-15 

files created on, 4-5 

generated system on, 4-5 

initialize, 1-13 
SYSGEN program, 1-22, 4-2 

allows patching, 4-6 

asks configuration questions, 4-2 

creates SYSGEN.CTL, 4-4 

generate RSTS/E system, 4-6 
SYSGEN system 

allocate system files, 3-47 

create SWAP.SYS only, 3-47 

default files for, 3-75 

default run-time system for, 1-6 

disk, 3-7, 3-11, 3-12, 5-1 

example of starting, 3-98 

files, 1-2 

hardvmre characteristics, 1-16 

job miaximum for, 3-73 

labelling default for, 3-88 

minimal device support, 1-2 

monitor, 1-16, 1-18, 3-1 

monitor name in, 3-44 

restart, 4-24 

RTll Run-Time System, 3-74 

set characteristics for, 1-20 

set defaults for, 1-20 

shut down, 1-3, 1-31, 4-1, 4-23 

start, 1-2, 1-22 

START option, 1-2 

swap maximum for, 3-73 

tailor, 1-2, 3-1, 3-4, 3-20 

Target system considerations, 3-47 
SYSGEN.CTL file, 1-31, 4-4 

SYSGEN builds, 4-22 
SYSGEN.SAV file 

for on-line generation, 7-2 
SYSGEN.SAV program, 1-4 

example of, 7-2 



SYSGEN.SIL file 

transferred by COPY, 3-20 
SYSTAT program 

monitor system performance, 4-15 
System 

generating RSTS/E Target, 1-3 

initialization code, 1-6 

shut down, 1-4 

start SYSGEN, 1-2, 1-22 

tailoring, 1-3 

timing, 3-41 
System code 

correct, 5-1 
System default 

run-time system, 1-4, 1-6 

setting, 3-71 

start-up conditions, 3-71 
System defaults 

DEFAULT option, 1-4 

list of, 3-71, 3-72 
System disk 

content of RSTS/E, 1-6 

copy of, 1-3 

definition of, 4-9 

SWAP.SYS on, 3-55 
System file 

account [0,1], 3-6 

allocation, 3-46, 3-47, 5-3 

BUFF.SYS, 3-46, 3-56, 3-58 

change allocation of, 3-57 

copy, 3-20 

CRASH.SYS, 3-46, 3-51, 3-52, 3-56, 3-58, 
3-81 

ERR. SYS, 3-46, 3-56, 3-58 

HELP.TXT, 6-21 

location, 3-51 

OVR.SYS, 3-46, 3-56, 3-58 

plan, 3-46 

planning optional, 3-51 

XBUF, 4-11 
System files 

auxiliary, 1-6 
System generation 

delete files, 4-5 

error messages, A-1 

explanation of examples, E-1 

files necessary for, 4-2 

flow chart of, 1-8, 1-9 

kits, 1-llt 

large system example, E-67 to E-128 

obtain files for, 7-2 

on-line, 7-1 

overview, 1-1 

small system example, E-2 to E-65 
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System help file 

create HELP.TXT, 6-21 
System library, 6-2 

account [1,2], 3-6, 6-2 

build, 6-10, 6-14 

control files, 1-5, D-1 

create and patch, 6-4 

create new, 7-3 

dismount, 6-17 

mount, 6-11 

patch, 6-14 

standard, 6-2, 6-4 
System library account [1,2] 

cluster size, 3-6 
System library files 

building, 1-4 
System message file 

create NOTICE.TXT, 6-20, 6-21 
System module sizes, B-2t, B-3t 
System start-up control files, 6-22 

verify, 1-4, 6-25 
System trap vectors 

reserved location, 3-37 
System-wide logical name, 6-13 

assignment of, 4-15 

monitor space requirement, 4-15 



Table 

cross reference, 4-3 

file status, 3-52, 3-54 to 3-56 

memory allocation, 3-75 

storage allocation, 3-46 

symbol, 3-23 
Tailoring 

new monitor, 7-3 

overview, 3-3 

SYSGEN system, 1-2, 3-4 

Target system, 1-4 
Target disk, 1-6 

bootstrap, 5-1 

copy patches to, 6-4 

copy Target files, 5-1 

definition, 1-6 

final, 6-2 

hardware characteristics, 1-34 

initialize, 1-13 

intermediate, 1-42 

transfer files to, 1-42, 6-1, 6-2 
Target monitor, 3-47 

generate, 1-31 

install, 1-3, 1-36, 5-1 



Target system 

allocate files for, 1-36, 3-47 

considerations in SYSGEN system, 3-47 

default run-time system, 3-74 

generate, 1-3, 3-1, 4-1 

initialize disk for, 3-7 

intermediate, 1-32, 1-43, 6-2 

job maximum for, 3-73 

monitor, 1-32, 1-34 

monitor name in, 3-45 

position files, 1-36 

set defaults for, 1-38 

start, 1-41, 5-1, 5-3 

steps to tailor, 5-1 

swap maximum for, 3-73 

tailoring, 1-3, 1-4, 3-20 

use COPY option, 5-2 

use DEFAULT option, 5-3 

use DSKINT option, 5-2 

use FILL option, 5-2 

use HARDWR option, 5-2 

use INSTALL option, 5-2 

use PATCH option, 5-2 

use REFRESH option, 5-3 

use SET option, 5-3 
TEIO magnetic tape 

load program bootstrap, 2-14, 2-15 
TECO editor, 4-23 

on distribution medium, 4-22 

edit files with, 4-22 
TECO Run-Time System 

add procedures, 4-22 

remove, 4-23 
TECO.RTS file, 4-2 
TECO.TEC file, 4-2 
Terminal 

2741, 4-8 

assignment of, 4-7 

buffer quota, 4-15 

buffer requirement, 4-14 

console, 4-7 

/DETACH from console, 6-12 

enable only console, 3-102 

fill characteristics for, 1-35, 5-2 

full duplex, 4-9 

IBM Remote Batch, 4-12 

interfaces, 4-7 
Terminal,2741, 4-9 

C360, 4-8 

code and keyboard arrangements, 4-8 

CORR, 4-8, 4-9 

EBCD, 4-8, 4-9 

SBCD, 4-8 
Terminal speed characteristics file 

create, 6-23 
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Terminals 

maximum lines for, 4-6 

maximum number, 4-6 
Terminology, 1-6 
Time format 

24-HOUR, 3-89 

AM/PM, 3-89 
Time sharing 

disable devices for, 3-95 

enable devices for, 3-95 

start, 1-4, 3-97, 6-25, 7-3 
Timing 

system, 3-41 
.TMP extension, 3-53 
Transmit Interrupt feature, 4-8 
Trap vector 

reserved locations, 3-37 
Trigonometric functions, 4-21 
TS03 magnetic tape 

load program bootstrap, 2-14, 2-15 
.TSK extension 

for run-time system, 6-15 
TTYSET command, 3-103 
TTYSET.SPD terminal speed characteristics 

file, 6-23 
TUlO magnetic tape 

load program bootstrap, 2-14, 2-15 
TU58 cassette tape drive, 3-28, 3-40 
TU58 suboption 

CTRL/Z response, 3-41 

example of, 3-41 

use of, 3-28, 3-40, 3-41 
Two-word math packages, 4-21t 



U 

UFD, 3-6 

for account [0,1], 3-6 

BADB.SYS entry, 3-6 

SATT.SYS entry, 3-6 

use in formula, 3-6 
UNIBUS address, 4-7 

non-standard, 3-37 
UNIBUS Mapping Register, 3-86 
UNISYS option 

as diagnostic tool, 3-102 

exaraiple of, 3-102 

use of, 3-3t, 3-102 
UNITS suboption 

invoke, 3-42 

REMOVE response in, 3-43 

RETURN response in, 3-43 

use of, 3-28t, 3-42, 3-43 



UNLOCK suboption, 3-76t 

example of, 3-83 

use of, 3-82 
UNPRIV suboption, 3-91t 

use of, 3-96 
USE PREVIOUS BAD BLOCK INFO question 

in DSKINT, 3-lOt 
User accounts 

create, 1-4 

limit of, 3-6 
User File Directory. See UFD 
USER symbol 

in Memory Allocation Table, 3-78t 
UTILTY program, 4-2, 4-23, 6-9, 6-17, 6-18 

add BASIC-PLUS-2, 6-10 

add RTll Run-Time System, 7-2 

add run-time system, 1-4, 7-3 

to add TECO, 4-22 

CACHE commands for FIP, 4-17 

to shut down SYSGEN, 1-31 

swapping files, 3-48, 3-51, 3-73 



Vector 

assignments, 1-5, 3-28, C-1 

devices with fixed, C-8 

find non-standard, 3-37 

FIS exception trap, 3-37 

floating, 1-5, C-1 

FPP exception trap, 3-37 

Memory Management Unit trap, 3-37 

memory parity trap, 3-37 

PIRQ trap, 3-37 

system trap, 3-37 
Vector address 

declaring non-standard, 3-37 

incorrect, 3-37 
VECTOR suboption 

CTRL/Z response, 3-37 

example of, 3-38 

invoke controller list, 3-29 

non-standard vector, 3-28 

non-standard vector address, 3-37 

REMOVE response, 3-37 

? response to, 3-30 

use of, 3-28t, 3-37 
Vectors 

interrupt, 1-5 
Verify 

system start-up control files, 1-4, 6-25 
VOLATILE response 

in SWITCH suboption, 3-42t 
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w 

Width 

line printer, 3-94 
Window Control Block 

directory information in, 4-13 

X 

XBUF memory, 3-85 
XBUF suboption, 3-76t 

example of, 3-85 

REMOVE response, 3-85 

reserve buffer space, 4-16 

use of, 3-84 
XBUF symbol 

in Memory Allocation Table, 3-78t 
XBUF system file, 4-11 

no locking memory, 3-81 

optimal size, 4-17 



Y 

YOUR PATTERN question 
in DSKINT option, 3-llt 
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